<!doctype html>
<html lang="zh-cn" dir="ltr">
 <head> 
  <meta charset="UTF-8"> 
  <title>会员卡专区 - 微信公众平台开发者文档</title> 
  <meta name="generator" content="MediaWiki 1.17.0"> 
  <link rel="shortcut icon" href="../static/assets/b6e57135e9c7167976dba80b3b09b546.jpg"> 
  <link rel="search" type="application/opensearchdescription+xml" href="../7/62453c80507e836458b441eae4358bdf.html" title="微信公众平台开发者文档 (zh-cn)"> 
  <link rel="alternate" type="application/atom+xml" title="微信公众平台开发者文档的Atom订阅" href="../0/594277f21545345653eb965322ac4b04.html"> 
  <link rel="stylesheet" href="../static/02da6b362196e50cd396d4117c7fa3ea.css"> 
  <meta name="keywords" content="微信公众平台开发者文档,微信小店接口,设备功能接口,Weixin JS接口,分组管理接口">
  <meta name="description" content="公众平台是为微信用户提供服务的平台，而公众平台开发接口则是提供服务的基础，开发者在公众平台网站中创建公众号、获取接口权限后，可以通过阅读本接口文档来帮助开发。">
  <meta name="ResourceLoaderDynamicStyles" content=""> 
  <!--[if lt IE 7]><style type="text/css">body{behavior:url("/wiki/skins/vector/csshover.min.htc")}</style><![endif]-->
 </head> 
 <body class="mediawiki ltr ns-0 ns-subject page-会员卡专区 skin-vector"> 
  <!--网站头部--> 
  <script type="text/javascript" src="../static/021402488e80774f4bae632d50abd818.js"></script> 
  <script>
	function parseURL(){
		var res = {}, search = location.search;
		if (search.indexOf("?") != 0){
			return res;
		}
		search = search.substr(1).split("&");
		for (var i = 0; i < search.length; ++i){
			var 
				item = search[i],
				idx = item.indexOf("="),
				k = item.substr(0, idx),
				v = item.substr(idx+1);
			res[k] = v;
		}
		return res;
	}

	var params = parseURL();
	$(function(){
		$(".portal").each(function(){
			var portal = $(this), as = portal.find('a');

			as.each(function(){
				var a = $(this), title = a.html();

				if (decodeURIComponent(title) == decodeURIComponent(params['title'])){
					portal.addClass("active").find(".body").show();
					a.addClass("selected");
				}
			});
		})
	});
</script> 
  <div class="headWrap"> 
   <div class="header" id="header"> 
    <div class="inner"> 
     <a class="logo" href="../home/index.html"><img src="../static/assets/dc5de672083b2ec495408b00b96c9aab.png" alt="微信公众平台开发者文档"></a> 
    </div> 
   </div> 
  </div>  
  <script type="text/javascript" src="../static/2ef2bdf6ac1839ee639cb15463231282.js"></script> 
  <!--[if IE 6]>
<style type="text/css">
html{background-image:url(about:blank);background-attachment:fixed;}
#content{overflow-x:hidden;}
.bottomnav{position:absolute;top:expression(eval(document.documentElement.scrollTop+document.documentElement.clientHeight-30));}
</style>
<![endif]--> 
  <!--网站头部--> 
  <div id="mw-page-base" class="noprint"></div> 
  <div id="mw-head-base" class="noprint"></div> 
  <div class="mainwrapper"> 
   <div class="inner"> 
    <!-- panel --> 
    <div id="mw-panel" class="noprint"> 
     <!-- 
						<div id="p-logo"><a style="background-image: url(/wiki/skins/common/images/logo.jpg);" href="/wiki/index.php?title=%E9%A6%96%E9%A1%B5"  title="访问首页"></a></div>
					
					<form class="searchform">
						<input type="text"   name="search" placeholder="搜索关键字 [alt-s]" accesskey="s" class="searchform_text"/>
						<input type="submit" name="fulltext" value="搜索" title="搜索该文字的页面" class="searchform_btn"/>
					</form>
					 --> 
     <!-- 开始前必读 --> 
     <div class="portal" id="p-.E5.BC.80.E5.A7.8B.E5.89.8D.E5.BF.85.E8.AF.BB"> 
      <h5><span class="portal_arrow"></span>开始前必读</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.9B.B4.E6.96.B0.E6.97.A5.E5.BF.97"><a href="../0/4c93e31f953f24a42b921d2ae8d4e5e0.html">更新日志</a></li> 
        <li id="n-.E5.BC.80.E5.8F.91.E8.80.85.E8.A7.84.E8.8C.83"><a href="../16/52e198333f5c127ddd5c45e875191b14.html">开发者规范</a></li> 
        <li id="n-.E5.85.AC.E4.BC.97.E5.8F.B7.E6.8E.A5.E5.8F.A3.E6.9D.83.E9.99.90.E8.AF.B4.E6.98.8E"><a href="../13/8d4957b72037e3308a0ca1b21f25ae8d.html">公众号接口权限说明</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E9.A2.91.E7.8E.87.E9.99.90.E5.88.B6.E8.AF.B4.E6.98.8E"><a href="../7/85eff372c164ddc66c47777dc972279f.html">接口频率限制说明</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E8.BF.94.E5.9B.9E.E7.A0.81.E8.AF.B4.E6.98.8E"><a href="../10/6380dc743053a91c544ffd2b7c959166.html">接口返回码说明</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /开始前必读 --> 
     <!-- 开始开发 --> 
     <div class="portal" id="p-.E5.BC.80.E5.A7.8B.E5.BC.80.E5.8F.91"> 
      <h5><span class="portal_arrow"></span>开始开发</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.8E.A5.E5.85.A5.E6.8C.87.E5.8D.97"><a href="../8/f9a0b8382e0b77d87b3bcc1ce6fbc104.html">接入指南</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E5.87.AD.E6.8D.AE"><a href="../14/9f9c82c1af308e3b14ba9b973f99a8ba.html">获取接口调用凭据</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.BE.AE.E4.BF.A1.E6.9C.8D.E5.8A.A1.E5.99.A8IP.E5.9C.B0.E5.9D.80"><a href="../4/41ef0843d6e108cf6b5649480207561c.html">获取微信服务器IP地址</a></li> 
        <li id="n-.E6.8A.A5.E8.AD.A6.E6.8E.92.E6.9F.A5.E6.8C.87.E5.BC.95"><a href="../7/c478375fae59150b26def82ec061f43b.html">报警排查指引</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E6.B5.8B.E8.AF.95.E5.8F.B7.E7.94.B3.E8.AF.B7"><a href="http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login">接口测试号申请</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E5.9C.A8.E7.BA.BF.E8.B0.83.E8.AF.95"><a href="http://mp.weixin.qq.com/debug/">接口在线调试</a></li> 
        <li id="n-.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><a href="http://mp.weixin.qq.com/qa">常见问题</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /开始开发 --> 
     <!-- 自定义菜单 --> 
     <div class="portal" id="p-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95"> 
      <h5><span class="portal_arrow"></span>自定义菜单</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E5.88.9B.E5.BB.BA.E6.8E.A5.E5.8F.A3"><a href="../10/0234e39a2025342c17a7d23595c6b40a.html">自定义菜单创建接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E6.9F.A5.E8.AF.A2.E6.8E.A5.E5.8F.A3"><a href="../5/f287d1a5b78a35a8884326312ac3e4ed.html">自定义菜单查询接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E5.88.A0.E9.99.A4.E6.8E.A5.E5.8F.A3"><a href="../3/de21624f2d0d3dafde085dafaa226743.html">自定义菜单删除接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../19/a037750e2df0261ab0a84899d16abd33.html">自定义菜单事件推送</a></li> 
        <li id="n-.E4.B8.AA.E6.80.A7.E5.8C.96.E8.8F.9C.E5.8D.95.E6.8E.A5.E5.8F.A3"><a href="../0/c48ccd12b69ae023159b4bfaa7c39c20.html">个性化菜单接口</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.85.AC.E4.BC.97.E5.8F.B7.E7.9A.84.E8.8F.9C.E5.8D.95.E9.85.8D.E7.BD.AE"><a href="../14/293d0cb8de95e916d1216a33fcb81fd6.html">获取公众号的菜单配置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /自定义菜单 --> 
     <!-- 消息管理 --> 
     <div class="portal" id="p-.E6.B6.88.E6.81.AF.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>消息管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.8E.A5.E6.94.B6.E6.B6.88.E6.81.AF-.E6.8E.A5.E6.94.B6.E6.99.AE.E9.80.9A.E6.B6.88.E6.81.AF"><a href="../17/f298879f8fb29ab98b2f2971d42552fd.html">接收消息-接收普通消息</a></li> 
        <li id="n-.E6.8E.A5.E6.94.B6.E6.B6.88.E6.81.AF-.E6.8E.A5.E6.94.B6.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../7/9f89d962eba4c5924ed95b513ba69d9b.html">接收消息-接收事件推送</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E8.A2.AB.E5.8A.A8.E5.9B.9E.E5.A4.8D.E6.B6.88.E6.81.AF"><a href="../1/6239b44c206cab9145b1d52c67e6c551.html">发送消息-被动回复消息</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E8.A2.AB.E5.8A.A8.E5.9B.9E.E5.A4.8D.E6.97.B6.E7.9A.84.E5.8A.A0.E8.A7.A3.E5.AF.86"><a href="../14/70e73cedf9fd958d2e23264ba9333ad2.html">发送消息-被动回复时的加解密</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E5.AE.A2.E6.9C.8D.E6.B6.88.E6.81.AF"><a href="../11/c88c270ae8935291626538f9c64bd123.html">发送消息-客服消息</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E7.BE.A4.E5.8F.91.E6.8E.A5.E5.8F.A3"><a href="../15/40b6865b893947b764e2de8e4a1fb55f.html">发送消息-群发接口</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E6.A8.A1.E6.9D.BF.E6.B6.88.E6.81.AF.E6.8E.A5.E5.8F.A3"><a href="../5/6dde9eaa909f83354e0094dc3ad99e05.html">发送消息-模板消息接口</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E6.A8.A1.E6.9D.BF.E6.B6.88.E6.81.AF.E8.BF.90.E8.90.A5.E8.A7.84.E8.8C.83"><a href="../18/8ecd0dfc9acafb2ed86ac3ae8f7c69aa.html">发送消息-模板消息运营规范</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.85.AC.E4.BC.97.E5.8F.B7.E8.87.AA.E5.8A.A8.E5.9B.9E.E5.A4.8D.E9.85.8D.E7.BD.AE"><a href="../8/806878e1fc2b9e9aa618ae33896b04c4.html">获取公众号自动回复配置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /消息管理 --> 
     <!-- 微信网页开发 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E5.BC.80.E5.8F.91"> 
      <h5><span class="portal_arrow"></span>微信网页开发</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E6.8E.88.E6.9D.83"><a href="../4/9ac2e7b1f1d22e9e57260f6553822520.html">微信网页授权</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E5.BC.80.E5.8F.91.E6.A0.B7.E5.BC.8F.E5.BA.93"><a href="../2/ae9782fb42e47ad79eb7b361c2149d16.html">微信网页开发样式库</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1JS-SDK"><a href="../11/74ad127cc054f6b80759c40f77ec03db.html">微信JS-SDK</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1Web.E5.BC.80.E5.8F.91.E8.80.85.E5.B7.A5.E5.85.B7"><a href="../10/e5f772f4521da17fa0d7304f68b97d7e.html">微信Web开发者工具</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信网页开发 --> 
     <!-- 素材管理 --> 
     <div class="portal" id="p-.E7.B4.A0.E6.9D.90.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>素材管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.96.B0.E5.A2.9E.E4.B8.B4.E6.97.B6.E7.B4.A0.E6.9D.90"><a href="../15/2d353966323806a202cd2deaafe8e557.html">新增临时素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E4.B8.B4.E6.97.B6.E7.B4.A0.E6.9D.90"><a href="../9/677a85e3f3849af35de54bb5516c2521.html">获取临时素材</a></li> 
        <li id="n-.E6.96.B0.E5.A2.9E.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../10/10ea5a44870f53d79449290dfd43d006.html">新增永久素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../12/3c12fac7c14cb4d0e0d4fe2fbc87b638.html">获取永久素材</a></li> 
        <li id="n-.E5.88.A0.E9.99.A4.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../7/2212203f4e17253b9aef77dc788f5337.html">删除永久素材</a></li> 
        <li id="n-.E4.BF.AE.E6.94.B9.E6.B0.B8.E4.B9.85.E5.9B.BE.E6.96.87.E7.B4.A0.E6.9D.90"><a href="../10/c7bad9a463db20ff8ccefeedeef51f9e.html">修改永久图文素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.B4.A0.E6.9D.90.E6.80.BB.E6.95.B0"><a href="../5/a641fd7b5db7a6a946ebebe2ac166885.html">获取素材总数</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.B4.A0.E6.9D.90.E5.88.97.E8.A1.A8"><a href="../15/8386c11b7bc4cdd1499c572bfe2e95b3.html">获取素材列表</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /素材管理 --> 
     <!-- 用户管理 --> 
     <div class="portal" id="p-.E7.94.A8.E6.88.B7.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>用户管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.A8.E6.88.B7.E5.88.86.E7.BB.84.E7.AE.A1.E7.90.86"><a href="../8/d6d33cf60bce2a2e4fb10a21be9591b8.html">用户分组管理</a></li> 
        <li id="n-.E8.AE.BE.E7.BD.AE.E7.94.A8.E6.88.B7.E5.A4.87.E6.B3.A8.E5.90.8D"><a href="../16/528098c4a6a87b05120a7665c8db0460.html">设置用户备注名</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.9F.BA.E6.9C.AC.E4.BF.A1.E6.81.AF.28UnionID.E6.9C.BA.E5.88.B6.29"><a href="../1/8a5ce6257f1d3b2afb20f83e72b72ce9.html">获取用户基本信息(UnionID机制)</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.88.97.E8.A1.A8"><a href="../12/54773ff6da7b8bdc95b7d2667d84b1d4.html">获取用户列表</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.9C.B0.E7.90.86.E4.BD.8D.E7.BD.AE"><a href="../4/0bd25e04332eccf83bc2e71df9d3e860.html">获取用户地理位置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /用户管理 --> 
     <!-- 帐号管理 --> 
     <div class="portal" id="p-.E5.B8.90.E5.8F.B7.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>帐号管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.9F.E6.88.90.E5.B8.A6.E5.8F.82.E6.95.B0.E7.9A.84.E4.BA.8C.E7.BB.B4.E7.A0.81"><a href="../18/167e7d94df85d8389df6c94a7a8f78ba.html">生成带参数的二维码</a></li> 
        <li id="n-.E9.95.BF.E9.93.BE.E6.8E.A5.E8.BD.AC.E7.9F.AD.E9.93.BE.E6.8E.A5.E6.8E.A5.E5.8F.A3"><a href="../6/856aaeb492026466277ea39233dc23ee.html">长链接转短链接接口</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E8.AE.A4.E8.AF.81.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../10/2adfb2f10828e87aa1e5c3ef83b17906.html">微信认证事件推送</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /帐号管理 --> 
     <!-- 数据统计 --> 
     <div class="portal" id="p-.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"> 
      <h5><span class="portal_arrow"></span>数据统计</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.A8.E6.88.B7.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../15/88726a421bfc54654a3095821c3ca3bb.html">用户分析数据接口</a></li> 
        <li id="n-.E5.9B.BE.E6.96.87.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../9/d347c6ddb6f86ab11ec3b41c2729c8d9.html">图文分析数据接口</a></li> 
        <li id="n-.E6.B6.88.E6.81.AF.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../10/b29e8ca8bf1b0dce033ccb70273f90fa.html">消息分析数据接口</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../17/252a976f20bd3062af3f03a45f30cff9.html">接口分析数据接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /数据统计 --> 
     <!-- 微信小店 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.B0.8F.E5.BA.97"> 
      <h5><span class="portal_arrow"></span>微信小店</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E5.B0.8F.E5.BA.97.E6.8E.A5.E5.8F.A3"><a href="../6/ae98ac4a7219405153cedc9dddccacca.html">微信小店接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信小店 --> 
     <!-- 微信卡券 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.8D.A1.E5.88.B8"> 
      <h5><span class="portal_arrow"></span>微信卡券</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../10/597cb57750f375a4b37e2536fd3331ea.html">微信卡券接口说明</a></li> 
        <li id="n-.E5.88.9B.E5.BB.BA.E5.8D.A1.E5.88.B8"><a href="../15/e33671f4ef511b77755142b37502928f.html">创建卡券</a></li> 
        <li id="n-.E6.8A.95.E6.94.BE.E5.8D.A1.E5.88.B8"><a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html">投放卡券</a></li> 
        <li id="n-.E6.A0.B8.E9.94.80.E5.8D.A1.E5.88.B8"><a href="../15/bdfd0c3c6c3b0629e8a425936a973d8b.html">核销卡券</a></li> 
        <li id="n-.E7.AE.A1.E7.90.86.E5.8D.A1.E5.88.B8"><a href="../14/8dd77aeaee85f922db5f8aa6386d385e.html">管理卡券</a></li> 
        <li id="n-.E5.8D.A1.E5.88.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../16/28b34ee91675a04cb24853768debded4.html">卡券事件推送</a></li> 
        <li id="n-.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E4.B8.93.E5.8C.BA"><a href="../10/333958907c5aae0581e93a24f2df8562.html">朋友的券专区</a></li> 
        <li id="n-.E4.BC.9A.E5.91.98.E5.8D.A1.E4.B8.93.E5.8C.BA"><a href="../15/de148cc4b5190c80002eaf4f6f26c717.html">会员卡专区</a></li> 
        <li id="n-.E7.89.B9.E6.AE.8A.E7.A5.A8.E5.88.B8"><a href="../11/a42da6431597edff7caeaf5d33fac37b.html">特殊票券</a></li> 
        <li id="n-.E7.AC.AC.E4.B8.89.E6.96.B9.E4.BB.A3.E5.88.B6.E4.B8.93.E5.8C.BA"><a href="../13/a1b2bedbca3990108195f13bd7e27401.html">第三方代制专区</a></li> 
        <li id="n-.E5.8D.A1.E5.88.B8.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../7/981e7a73e2bca37a3d1c83f071be6947.html">卡券错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信卡券 --> 
     <!-- 微信门店 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97"> 
      <h5><span class="portal_arrow"></span>微信门店</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97.E6.8E.A5.E5.8F.A3"><a href="../11/081986f089826bf94393bef9bf287b8b.html">微信门店接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信门店 --> 
     <!-- 微信智能接口 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.99.BA.E8.83.BD.E6.8E.A5.E5.8F.A3"> 
      <h5><span class="portal_arrow"></span>微信智能接口</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.AF.AD.E4.B9.89.E7.90.86.E8.A7.A3.E6.8E.A5.E5.8F.A3"><a href="../10/65eb7a43f078cc609cf08dae6805f4a6.html">语义理解接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信智能接口 --> 
     <!-- 微信设备功能 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E8.AE.BE.E5.A4.87.E5.8A.9F.E8.83.BD"> 
      <h5><span class="portal_arrow"></span>微信设备功能</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.AE.BE.E5.A4.87.E5.8A.9F.E8.83.BD.E4.BB.8B.E7.BB.8D"><a href="../2/77400d13dc7fca83181bc9806d55b6ce.html">设备功能介绍</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信设备功能 --> 
     <!-- 微信多客服功能 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.A4.9A.E5.AE.A2.E6.9C.8D.E5.8A.9F.E8.83.BD"> 
      <h5><span class="portal_arrow"></span>微信多客服功能</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.B0.86.E6.B6.88.E6.81.AF.E8.BD.AC.E5.8F.91.E5.88.B0.E5.A4.9A.E5.AE.A2.E6.9C.8D"><a href="../11/f0e34a15cec66fefb28cf1c0388f68ab.html">将消息转发到多客服</a></li> 
        <li id="n-.E5.AE.A2.E6.9C.8D.E7.AE.A1.E7.90.86"><a href="../18/749901f4e123170fb8a4d447ae6040ba.html">客服管理</a></li> 
        <li id="n-.E5.A4.9A.E5.AE.A2.E6.9C.8D.E4.BC.9A.E8.AF.9D.E6.8E.A7.E5.88.B6"><a href="../4/4b256cfb246b22ad020e07cf8a61a738.html">多客服会话控制</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.AE.A2.E6.9C.8D.E8.81.8A.E5.A4.A9.E8.AE.B0.E5.BD.95"><a href="../3/178d2982bd590adf33fc03cf6cf45b33.html">获取客服聊天记录</a></li> 
        <li id="n-PC.E5.AE.A2.E6.88.B7.E7.AB.AF.E8.87.AA.E5.AE.9A.E4.B9.89.E6.8F.92.E4.BB.B6.E6.8E.A5.E5.8F.A3"><a href="../8/3634566e351f497f508c7b9d04636724.html">PC客户端自定义插件接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信多客服功能 --> 
     <!-- 微信摇一摇周边 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9"> 
      <h5><span class="portal_arrow"></span>微信摇一摇周边</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.B3.E8.AF.B7.E5.BC.80.E9.80.9A.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9"><a href="../19/9fe9fdbb50fee9f9660438c551142ccf.html">申请开通摇一摇周边</a></li> 
        <li id="n-.E8.AE.BE.E5.A4.87.E7.AE.A1.E7.90.86"><a href="../15/095caa2f4a829f0299db617eaf6ad1cf.html">设备管理</a></li> 
        <li id="n-.E9.A1.B5.E9.9D.A2.E7.AE.A1.E7.90.86"><a href="../15/7a21268ed234b4e648d86e3b91118907.html">页面管理</a></li> 
        <li id="n-.E7.B4.A0.E6.9D.90.E7.AE.A1.E7.90.86"><a href="../12/3b10084ee944a702fd06e54a0f10b1d8.html">素材管理</a></li> 
        <li id="n-.E7.AE.A1.E7.90.86.E8.AE.BE.E5.A4.87.E4.B8.8E.E9.A1.B5.E9.9D.A2.E7.9A.84.E5.85.B3.E8.81.94.E5.85.B3.E7.B3.BB"><a href="../6/0eb3f80f152d2edb95287141e7a6ab5e.html">管理设备与页面的关联关系</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E8.AE.BE.E5.A4.87.E5.8F.8A.E7.94.A8.E6.88.B7.E4.BF.A1.E6.81.AF"><a href="../12/f18e741c4cab6652afe3878774672de4.html">获取设备及用户信息</a></li> 
        <li id="n-.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><a href="../3/15da0147e3722fd689f363497af0c707.html">数据统计</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E5.85.B3.E6.B3.A8JSAPI"><a href="../4/94e3b1dc0416633a2d7f1cfaa71240c8.html">摇一摇关注JSAPI</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E4.BA.8B.E4.BB.B6.E9.80.9A.E7.9F.A5"><a href="../3/c71248e1b3efb158f258a48b72e67683.html">摇一摇事件通知</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E7.BA.A2.E5.8C.85"><a href="../7/0ddd50ed2421b99fedd071281c074aab.html">摇一摇红包</a></li> 
        <li id="n-Html-5.E9.A1.B5.E9.9D.A2.E8.8E.B7.E5.8F.96.E8.AE.BE.E5.A4.87.E4.BF.A1.E6.81.AF"><a href="../11/c156a3e968b0c1e78157e15275dcc54b.html">Html 5页面获取设备信息</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../1/8299371e6e11392757b23a6d1e592331.html">摇一摇周边错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信摇一摇周边 --> 
     <!-- 微信连Wi-Fi --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi"> 
      <h5><span class="portal_arrow"></span>微信连Wi-Fi</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi.E5.BC.80.E5.8F.91.E8.80.85.E6.8C.87.E5.BC.95"><a href="../9/fd2d692e28b938a8d618f57cf9c79fb1.html">微信连Wi-Fi开发者指引</a></li> 
        <li id="n-Wi-Fi.E7.A1.AC.E4.BB.B6.E9.89.B4.E6.9D.83.E5.8D.8F.E8.AE.AE.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../10/0ef643c7147fdf689e0a780d8c08ab96.html">Wi-Fi硬件鉴权协议接口说明</a></li> 
        <li id="n-Wi-Fi.E8.BD.AF.E4.BB.B6.E6.9C.8D.E5.8A.A1.E7.AE.A1.E7.90.86.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../14/70e147b2ace3247f88f1c2aaaa57568e.html">Wi-Fi软件服务管理接口说明</a></li> 
        <li id="n-.E5.BC.80.E9.80.9A.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi.E6.8F.92.E4.BB.B6"><a href="../11/a6a3731b23ed4203f5d08030cd5bf4c3.html">开通微信连Wi-Fi插件</a></li> 
        <li id="n-Wi-Fi.E9.97.A8.E5.BA.97.E7.AE.A1.E7.90.86"><a href="../9/0afbb08a0f06e87dd3669a2c1e19edd5.html">Wi-Fi门店管理</a></li> 
        <li id="n-Wi-Fi.E8.AE.BE.E5.A4.87.E7.AE.A1.E7.90.86"><a href="../17/438e819a53e9426b202c3bc0afbad749.html">Wi-Fi设备管理</a></li> 
        <li id="n-.E9.85.8D.E7.BD.AE.E8.BF.9E.E7.BD.91.E6.96.B9.E5.BC.8F"><a href="../17/22648869929525f829a3de1bfc73eb4d.html">配置连网方式</a></li> 
        <li id="n-.E5.95.86.E5.AE.B6.E4.B8.BB.E9.A1.B5.E7.AE.A1.E7.90.86"><a href="../14/4e14adf8639aeb67d42df05cb792da9e.html">商家主页管理</a></li> 
        <li id="n-Wi-Fi.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><a href="../11/f5f481aeeb62b9b0848315f78123b4d7.html">Wi-Fi数据统计</a></li> 
        <li id="n-.E8.BF.9E.E7.BD.91.E5.90.8E.E4.B8.8B.E5.8F.91.E6.B6.88.E6.81.AF"><a href="../19/bac84e64da24f928c3e536c742d4e0b7.html">连网后下发消息</a></li> 
        <li id="n-Wi-Fi.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../9/b1211ca9404ec481f94e88d0dd344e85.html">Wi-Fi错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信连Wi-Fi --> 
     <!-- 微信扫一扫 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.89.AB.E4.B8.80.E6.89.AB"> 
      <h5><span class="portal_arrow"></span>微信扫一扫</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E6.8E.A5.E5.85.A5.E6.8C.87.E5.8D.97"><a href="../19/e833eb10470cc25cad4719677c46ecdb.html">扫一扫接入指南</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E5.88.9B.E5.BB.BA"><a href="../6/c61604ff6890d386d6227945ad4a68d2.html">商品创建</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E5.8F.91.E5.B8.83"><a href="../15/1007691d0f1c10a0588c6517f12ed70f.html">商品发布</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E7.AE.A1.E7.90.86"><a href="../15/7fa787701295b884410b5163e13313af.html">商品管理</a></li> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../15/f4109a5e44b4bfbc7eb1337eb739f3e3.html">扫一扫事件推送</a></li> 
        <li id="n-.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../7/91dcb5ffa7d087a23299316c3c396e93.html">错误码</a></li> 
        <li id="n-.E5.9C.A8.E7.BA.BF.E5.B8.AE.E5.8A.A9.E5.B7.A5.E5.85.B7"><a href="../11/9f75990a5e9f6c09c846fd918921e0d7.html">在线帮助工具</a></li> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><a href="../15/b11cde45d1dcb23a94f493dd1e1320cb.html">扫一扫常见问题</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信扫一扫 --> 
     <!-- SEARCH --> 
     <!-- /SEARCH --> 
     <!-- TOOLBOX --> 
     <!-- /TOOLBOX --> 
     <!-- LANGUAGES --> 
     <!-- /LANGUAGES --> 
    </div> 
    <!-- /panel --> 
    <!-- content --> 
    <div id="content"> 
     <!-- header --> 
     <div id="mw-head" class="noprint" style="visibility:hidden"> 
      <!-- 0 --> 
      <div id="p-personal" class=""> 
       <h5>个人工具</h5> 
       <ul> 
        <li id="pt-anonuserpage"><a href="../0/f33145bff5a2445cabbd49fc12e8f2e0.html" title="您编辑本站所用IP的对应用户页 [.]" accesskey="." class="new">10.9.161.40</a></li> 
        <li id="pt-anontalk"><a href="../12/4aa3e991f9670e48be3d9c6d01c4c568.html" title="对于来自此IP地址的编辑的对话 [n]" accesskey="n" class="new">该IP的讨论页</a></li> 
        <li id="pt-anonlogin"><a href="../7/a2ab5a0cb74f9b69de922218d6236923.html" title="我们鼓励您登录，但这并不是必须的 [o]" accesskey="o">登录</a></li> 
       </ul> 
      </div> 
      <!-- /0 --> 
      <div id="left-navigation"> 
       <!-- 0 --> 
       <div id="p-namespaces" class="vectorTabs"> 
        <h5>名字空间</h5> 
        <ul> 
         <li id="ca-nstab-main" class="selected"><span><a href="../15/de148cc4b5190c80002eaf4f6f26c717.html" title="查看页面内容 [c]" accesskey="c">页面</a></span></li> 
         <li id="ca-talk" class="new"><span><a href="#" title="关于页面正文的讨论 [t]" accesskey="t">讨论</a></span></li> 
        </ul> 
       </div> 
       <!-- /0 --> 
       <!-- 1 --> 
       <div id="p-variants" class="vectorMenu emptyPortlet"> 
        <h5><span>变换</span><a href="#"></a></h5> 
        <div class="menu"> 
         <ul> 
         </ul> 
        </div> 
       </div> 
       <!-- /1 --> 
      </div> 
      <div id="right-navigation"> 
       <!-- 0 --> 
       <div id="p-views" class="vectorTabs"> 
        <h5>查看</h5> 
        <ul> 
         <li id="ca-view" class="selected"><span><a href="../15/de148cc4b5190c80002eaf4f6f26c717.html">阅读</a></span></li> 
         <li id="ca-viewsource"><span><a href="#" title="此页面已被保护，你可以查看其源代码。 [e]" accesskey="e">查看源代码</a></span></li> 
         <li id="ca-history" class="collapsible "><span><a href="#" title="此页面的早前修订版本 [h]" accesskey="h">查看历史</a></span></li> 
        </ul> 
       </div> 
       <!-- /0 --> 
       <!-- 1 --> 
       <div id="p-cactions" class="vectorMenu emptyPortlet"> 
        <h5><span>动作</span><a href="#"></a></h5> 
        <div class="menu"> 
         <ul> 
         </ul> 
        </div> 
       </div> 
       <!-- /1 --> 
       <!-- 2 --> 
       <div id="p-search"> 
        <h5><label for="searchInput">搜索</label></h5> 
        <form action="/wiki/index.php" id="searchform"> 
         <input type="hidden" name="title" value="特殊:搜索"> 
         <input id="searchInput" name="search" type="text" title="搜索该网站 [f]" accesskey="f" value=""> 
         <input type="submit" name="go" class="searchButton" id="searchGoButton" value="进入" title="如果相同的标题存在的话便直接前往该页面"> 
         <input type="submit" name="fulltext" class="searchButton" id="mw-searchButton" value="搜索" title="搜索该文字的页面"> 
        </form> 
       </div> 
       <!-- /2 --> 
      </div> 
     </div> 
     <!-- /header --> 
     <a id="top"></a> 
     <div id="mw-js-message" style="display:none;"></div> 
     <!-- firstHeading --> 
     <div class="content_hd"> 
      <h2 id="firstHeading" class="">会员卡专区</h2> 
      <div class="info"> 
      </div> 
     </div> 
     <!-- /firstHeading --> 
     <!-- bodyContent --> 
     <div id="bodyContent" class="bodyContent"> 
      <!-- tagline --> 
      <div id="siteSub">
       出自微信公众平台开发者文档
      </div> 
      <!-- /tagline --> 
      <!-- subtitle --> 
      <div id="contentSub"></div> 
      <!-- /subtitle --> 
      <!-- jumpto --> 
      <div id="jump-to-nav">
        跳转到： 
       <a href="#mw-head">导航</a>, 
       <a href="#p-search">搜索</a> 
      </div> 
      <!-- /jumpto --> 
      <!-- bodytext --> 
      <table id="toc" class="toc">
       <tbody>
        <tr>
         <td>
          <div id="toctitle">
           <h2>目录</h2>
          </div> 
          <ul> 
           <li class="toclevel-1 tocsection-1"><a href="#.E6.9B.B4.E6.96.B0.E6.97.A5.E5.BF.97"><span class="tocnumber">1</span> <span class="toctext">更新日志</span></a></li> 
           <li class="toclevel-1 tocsection-2"><a href="#.E6.8E.A5.E5.85.A5.E4.BC.9A.E5.91.98.E5.8D.A1"><span class="tocnumber">2</span> <span class="toctext">接入会员卡</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-3"><a href="#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E5.88.9B.E5.BB.BA.E4.BC.9A.E5.91.98.E5.8D.A1"><span class="tocnumber">2.1</span> <span class="toctext">步骤一：创建会员卡</span></a></li> 
             <li class="toclevel-2 tocsection-4"><a href="#.E6.AD.A5.E9.AA.A4.E4.BA.8C.EF.BC.9A.E8.8E.B7.E5.8F.96.E4.BC.9A.E5.91.98.E5.8D.A1.E5.AE.A1.E6.A0.B8.E7.BB.93.E6.9E.9C"><span class="tocnumber">2.2</span> <span class="toctext">步骤二：获取会员卡审核结果</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-5"><a href="#.E5.AE.A1.E6.A0.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><span class="tocnumber">2.2.1</span> <span class="toctext">审核事件推送</span></a></li> 
               <li class="toclevel-3 tocsection-6"><a href="#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3"><span class="tocnumber">2.2.2</span> <span class="toctext">查看卡券详情接口</span></a></li> 
               <li class="toclevel-3 tocsection-7"><a href="#.E8.AE.BE.E7.BD.AE.E6.B5.8B.E8.AF.95.E7.99.BD.E5.90.8D.E5.8D.95"><span class="tocnumber">2.2.3</span> <span class="toctext">设置测试白名单</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-8"><a href="#.E6.AD.A5.E9.AA.A4.E4.B8.89.EF.BC.9A.E6.8A.95.E6.94.BE.E4.BC.9A.E5.91.98.E5.8D.A1"><span class="tocnumber">2.3</span> <span class="toctext">步骤三：投放会员卡</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-9"><a href="#.E5.88.9B.E5.BB.BA.E4.BA.8C.E7.BB.B4.E7.A0.81.E6.8E.A5.E5.8F.A3"><span class="tocnumber">2.3.1</span> <span class="toctext">创建二维码接口</span></a></li> 
               <li class="toclevel-3 tocsection-10"><a href="#.E6.B7.BB.E5.8A.A0.E5.8D.A1.E5.88.B8JS-SDK"><span class="tocnumber">2.3.2</span> <span class="toctext">添加卡券JS-SDK</span></a></li> 
               <li class="toclevel-3 tocsection-11"><a href="#.E9.80.9A.E8.BF.87.E5.8D.A1.E5.88.B8.E8.B4.A7.E6.9E.B6.E6.8A.95.E6.94.BE.E5.8D.A1.E5.88.B8"><span class="tocnumber">2.3.3</span> <span class="toctext">通过卡券货架投放卡券</span></a></li> 
               <li class="toclevel-3 tocsection-12"><a href="#.E7.BE.A4.E5.8F.91.E5.8D.A1.E5.88.B8"><span class="tocnumber">2.3.4</span> <span class="toctext">群发卡券</span></a></li> 
               <li class="toclevel-3 tocsection-13"><a href="#.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><span class="tocnumber">2.3.5</span> <span class="toctext">领取事件推送</span></a></li> 
               <li class="toclevel-3 tocsection-14"><a href="#.E6.8A.95.E6.94.BE.E6.B8.A0.E9.81.93.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><span class="tocnumber">2.3.6</span> <span class="toctext">投放渠道数据统计</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-15"><a href="#.E6.AD.A5.E9.AA.A4.E5.9B.9B.EF.BC.9A.E6.BF.80.E6.B4.BB.2F.E7.BB.91.E5.AE.9A.E4.BC.9A.E5.91.98.E5.8D.A1"><span class="tocnumber">2.4</span> <span class="toctext">步骤四：激活/绑定会员卡</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-16"><a href="#.E6.8E.A5.E5.8F.A3.E6.BF.80.E6.B4.BB"><span class="tocnumber">2.4.1</span> <span class="toctext">接口激活</span></a></li> 
               <li class="toclevel-3 tocsection-17"><a href="#.E4.B8.80.E9.94.AE.E5.BC.80.E5.8D.A1"><span class="tocnumber">2.4.2</span> <span class="toctext">一键开卡</span></a></li> 
               <li class="toclevel-3 tocsection-18"><a href="#.E8.87.AA.E5.8A.A8.E6.BF.80.E6.B4.BB"><span class="tocnumber">2.4.3</span> <span class="toctext">自动激活</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-19"><a href="#.E6.AD.A5.E9.AA.A4.E4.BA.94.EF.BC.9A.E6.9B.B4.E6.96.B0.E4.BC.9A.E5.91.98.E4.BF.A1.E6.81.AF"><span class="tocnumber">2.5</span> <span class="toctext">步骤五：更新会员信息</span></a></li> 
            </ul> </li> 
           <li class="toclevel-1 tocsection-20"><a href="#.E7.AE.A1.E7.90.86.E4.BC.9A.E5.91.98.E5.8D.A1"><span class="tocnumber">3</span> <span class="toctext">管理会员卡</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-21"><a href="#.E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.1</span> <span class="toctext">查询Code接口</span></a></li> 
             <li class="toclevel-2 tocsection-22"><a href="#.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.B7.B2.E9.A2.86.E5.8F.96.E7.9A.84.E5.8D.A1.E5.88.B8"><span class="tocnumber">3.2</span> <span class="toctext">获取用户已领取的卡券</span></a></li> 
             <li class="toclevel-2 tocsection-23"><a href="#.E6.8B.89.E5.8F.96.E4.BC.9A.E5.91.98.E4.BF.A1.E6.81.AF.EF.BC.88.E7.A7.AF.E5.88.86.E6.9F.A5.E8.AF.A2.EF.BC.89.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.3</span> <span class="toctext">拉取会员信息（积分查询）接口</span></a></li> 
             <li class="toclevel-2 tocsection-24"><a href="#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85"><span class="tocnumber">3.4</span> <span class="toctext">查看卡券详情</span></a></li> 
             <li class="toclevel-2 tocsection-25"><a href="#.E6.89.B9.E9.87.8F.E6.9F.A5.E8.AF.A2.E5.8D.A1.E5.88.97.E8.A1.A8"><span class="tocnumber">3.5</span> <span class="toctext">批量查询卡列表</span></a></li> 
             <li class="toclevel-2 tocsection-26"><a href="#.E6.9B.B4.E6.94.B9.E5.8D.A1.E5.88.B8.E4.BF.A1.E6.81.AF.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.6</span> <span class="toctext">更改卡券信息接口</span></a></li> 
             <li class="toclevel-2 tocsection-27"><a href="#.E4.BF.AE.E6.94.B9.E5.BA.93.E5.AD.98.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.7</span> <span class="toctext">修改库存接口</span></a></li> 
             <li class="toclevel-2 tocsection-28"><a href="#.E8.AE.BE.E7.BD.AE.E8.B7.9F.E9.9A.8F.E6.8E.A8.E8.8D.90"><span class="tocnumber">3.8</span> <span class="toctext">设置跟随推荐</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-29"><a href="#.E8.AE.BE.E7.BD.AE.E8.B7.9F.E9.9A.8F.E6.8E.A8.E8.8D.90.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.8.1</span> <span class="toctext">设置跟随推荐接口</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-30"><a href="#.E8.AE.BE.E7.BD.AE.E5.BE.AE.E4.BF.A1.E4.B9.B0.E5.8D.95.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.9</span> <span class="toctext">设置微信买单接口</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-31"><a href="#.E8.AE.BE.E7.BD.AE.E4.B9.B0.E5.8D.95.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.9.1</span> <span class="toctext">设置买单接口</span></a></li> 
               <li class="toclevel-3 tocsection-32"><a href="#.E4.B9.B0.E5.8D.95.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><span class="tocnumber">3.9.2</span> <span class="toctext">买单事件推送</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-33"><a href="#.E5.88.A0.E9.99.A4.E5.8D.A1.E5.88.B8"><span class="tocnumber">3.10</span> <span class="toctext">删除卡券</span></a></li> 
             <li class="toclevel-2 tocsection-34"><a href="#.E8.AE.BE.E7.BD.AE.E5.8D.A1.E5.88.B8.E5.A4.B1.E6.95.88.E6.8E.A5.E5.8F.A3"><span class="tocnumber">3.11</span> <span class="toctext">设置卡券失效接口</span></a></li> 
            </ul> </li> 
           <li class="toclevel-1 tocsection-35"><a href="#.E7.BB.9F.E8.AE.A1.E4.BC.9A.E5.91.98.E5.8D.A1.E6.95.B0.E6.8D.AE"><span class="tocnumber">4</span> <span class="toctext">统计会员卡数据</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-36"><a href="#.E6.8B.89.E5.8F.96.E4.BC.9A.E5.91.98.E5.8D.A1.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><span class="tocnumber">4.1</span> <span class="toctext">拉取会员卡数据接口</span></a></li> 
            </ul> </li> 
          </ul> </td>
        </tr>
       </tbody>
      </table> 
      <h1> <span class="mw-headline" id=".E6.9B.B4.E6.96.B0.E6.97.A5.E5.BF.97"> 更新日志 </span></h1> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">版本号 </th> 
         <th>更新内容 </th> 
         <th>更新时间 </th>
        </tr> 
        <tr> 
         <td> V1.2 </td> 
         <td> 支持直接传入积分、余额的全量值 </td> 
         <td> 2015-8-17 </td>
        </tr> 
        <tr> 
         <td> V1.2.1 </td> 
         <td> 支持在创建和更新接口填入auto_activate字段将会员卡设置为自动激活 </td> 
         <td> 2015-8-25 </td>
        </tr> 
        <tr> 
         <td> V1.2.2 </td> 
         <td> 1.新增会员一键激活接口，用户领卡后用微信原生激活页面。 <p>2.新增设置微信买单接口，支持开发者将已有会员更新为支持买单的会员卡。 3.新增设置消息跟随推荐接口，允许开发者在积分变动消息上推荐卡券或者url。 </p> </td> 
         <td> 2015-9-8 </td>
        </tr> 
        <tr> 
         <td> V1.2.3 </td> 
         <td> 开发者可以对会员卡传入积分规则、抵扣规则和会员卡折扣属性，在会员卡买单时生效。 </td> 
         <td> 2015-9-21 </td>
        </tr> 
       </tbody>
      </table> 
      <h1> <span class="mw-headline" id=".E6.8E.A5.E5.85.A5.E4.BC.9A.E5.91.98.E5.8D.A1"> 接入会员卡 </span></h1> 
      <p>支持开发者调用接口创建会员卡接口，获取会员卡cardid，该cardid通过审核后即可调用投放接口进行会员卡投放。当用户领取到未激活的会员卡后，开发者调用接口将会员信息同步至该会员卡上（激活/绑定会员卡接口）。用户使用会员卡时，通过调用接口（会员卡交易接口）进行积分、余额、等级等信息的更新。 </p>
      <p>值得注意的是，会员卡接口支持开发者将date_type设置为DATE_TYPE_PERMANENT，表示该会员卡永久有效。 </p>
      <p><a href="#" class="image"><img alt="会员接口调用流程.png" src="../static/assets/dda7f97ecda4d07f9dfe178c48369958.png" width="573" height="293"></a> </p> 
      <h2> <span class="mw-headline" id=".E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E5.88.9B.E5.BB.BA.E4.BC.9A.E5.91.98.E5.8D.A1"><b>步骤一：创建会员卡</b></span></h2> 
      <p>支持开发者调用该接口创建会员卡，获取cardid。审核结果可通过<a href="../16/28b34ee91675a04cb24853768debded4.html#.E5.AE.A1.E6.A0.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">审核事件通知</a>获取，同时支持调用<a href="../14/0b696beb159483c7bc8f75749512908e.html#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85" class="external text" rel="nofollow">查看卡券详情接口</a>查看卡券状态。 </p>
      <p><b>开发者注意事项</b> </p>
      <p>创建会员卡时需设置会员卡激活后呈现的会员信息类目，目前支持积分、余额、等级、优惠券、里程、印花、成就、折扣等类型，微信6.2版本显示会员信息类目的上限为3个，即创建时类目字段supply_bonus 、supply_balance、 custom_field1、custom_field2 、custom_field3最多选择三项填写。 </p>
      <p><br> <a href="#" class="image"><img alt="会员卡详细字段1.png" src="../static/assets/0d3b93cd0dcc43938bb316329fb04a0d.png" width="612" height="635"></a> </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p>POST数据示例： </p> 
      <pre>{
   "card": {
       "card_type": "MEMBER_CARD",
       "member_card": {
           "base_info": {
               "logo_url": "<a href="http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0</a>",
               "brand_name": "海底捞",
               "code_type": "CODE_TYPE_TEXT",
               "title": "海底捞会员卡",
               "color": "Color010",
               "notice": "使用时向服务员出示此券",
               "service_phone": "020-88888888",
               "description": "不可与其他优惠同享",
               "date_info": {
                   "type": "DATE_TYPE_PERMANENT"
               },
               "sku": {
                   "quantity": 50000000
               },
               "get_limit": 3,
               "use_custom_code": false,
               "can_give_friend": true,
               "location_id_list": [
                   123,
                   12321,
                   345345
               ],
               "custom_url_name": "立即使用",
               "custom_url": "<a href="http://www.xxx.com" class="external free" rel="nofollow">http://www.xxx.com</a>",
               "custom_url_sub_title": "6个汉字tips",
               "promotion_url_name": "营销入口1",
               "promotion_url": "<a href="http://www.xxx.com" class="external free" rel="nofollow">http://www.xxx.com</a>",
               "need_push_on_view": true
           },
           "supply_bonus": true,
           "supply_balance": false,
           "prerogative": "test_prerogative",
           "auto_activate": true,
           "custom_field1": {
               "name_type": "FIELD_NAME_TYPE_LEVEL",
               "url": "<a href="http://www.xxx.com" class="external free" rel="nofollow">http://www.xxx.com</a>"
           },
           "activate_url": "<a href="http://www.xxx.com" class="external free" rel="nofollow">http://www.xxx.com</a>",
           "custom_cell1": {
               "name": "使用入口2",
               "tips": "激活后显示",
               "url": "<a href="http://www.xxx.com" class="external free" rel="nofollow">http://www.xxx.com</a>"
           },
           "bonus_rule": {
              "cost_money_unit": 100,
              "increase_bonus": 1,
              "max_increase_bonus": 200,
              "init_increase_bonus": 10,
              "cost_bonus_unit": 5,          
              "reduce_money":  100,            
              "least_money_to_use_bonus": 1000, 
              "max_reduce_bonus": 50
           },
           "discount": 10
       }
   }
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:60px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>card_type </td> 
         <td>是 </td> 
         <td>string(24) </td> 
         <td>MEMBER_CARD </td> 
         <td>会员卡类型。 </td>
        </tr> 
        <tr> 
         <td>base_info </td> 
         <td>是 </td> 
         <td> Json结构 </td> 
         <td> 见上述示例。 </td> 
         <td>基本的卡券数据，见下表，所有卡券类型通用。 </td>
        </tr> 
        <tr> 
         <td>prerogative </td> 
         <td>是 </td> 
         <td>string（3072） </td> 
         <td>持白金会员卡到店消费，可享8折优惠。 </td> 
         <td>会员卡特权说明。 </td>
        </tr> 
        <tr> 
         <td>auto_activate </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>true </td> 
         <td>设置为true时用户领取会员卡后系统自动将其激活，无需调用激活接口，详情见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E8.87.AA.E5.8A.A8.E6.BF.80.E6.B4.BB" class="external text" rel="nofollow">自动激活</a>。 </td>
        </tr> 
        <tr> 
         <td>wx_activate </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>true </td> 
         <td>设置为true时会员卡支持一键开卡，不允许同时传入activate_url字段，否则设置wx_activate失效。填入该字段后仍需调用接口设置开卡项方可生效，详情见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E4.B8.80.E9.94.AE.E5.BC.80.E5.8D.A1" class="external text" rel="nofollow">一键开卡</a>。 </td>
        </tr> 
        <tr> 
         <td>supply_bonus </td> 
         <td>是 </td> 
         <td>bool </td> 
         <td>true </td> 
         <td>显示积分，填写true或false，如填写true，积分相关字段均为必填。 </td>
        </tr> 
        <tr> 
         <td>bonus_url </td> 
         <td>否 </td> 
         <td>string(32) </td> 
         <td>xxxx.com </td> 
         <td>设置跳转外链查看积分详情。仅适用于积分无法通过激活接口同步的情况下使用该字段。 </td>
        </tr> 
        <tr> 
         <td>supply_balance </td> 
         <td>是 </td> 
         <td>bool </td> 
         <td>true </td> 
         <td>是否支持储值，填写true或false。如填写true，储值相关字段均为必填。 </td>
        </tr> 
        <tr> 
         <td>balance_url </td> 
         <td>否 </td> 
         <td>string(32) </td> 
         <td>xxxx.com </td> 
         <td>设置跳转外链查看余额详情。仅适用于余额无法通过激活接口同步的情况下使用该字段。 </td>
        </tr> 
        <tr> 
         <td>custom_field1 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>custom_field2 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>custom_field3 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>name_type </td> 
         <td>否 </td> 
         <td>string(24) </td> 
         <td>FIELD_NAME_TYPE_LEVEL </td> 
         <td>会员信息类目名称。FIELD_NAME_TYPE_LEVEL等级；FIELD_NAME_TYPE_COUPON优惠券；FIELD_NAME_TYPE_STAMP印花；FIELD_NAME_TYPE_DISCOUNT折扣；FIELD_NAME_TYPE_ACHIEVEMEN成就；FIELD_NAME_TYPE_MILEAGE里程。 </td>
        </tr> 
        <tr> 
         <td>url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>xxx.com </td> 
         <td>点击类目跳转外链url </td>
        </tr> 
        <tr> 
         <td>bonus_cleared </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>每年年底12月30号积分清0。 </td> 
         <td>积分清零规则。 </td>
        </tr> 
        <tr> 
         <td>bonus_rules </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>每消费一元获取1点积分。 </td> 
         <td>积分规则。 </td>
        </tr> 
        <tr> 
         <td>balance_rules </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>xxx.com </td> 
         <td>储值说明。 </td>
        </tr> 
        <tr> 
         <td>activate_url </td> 
         <td>是 </td> 
         <td>string（128） </td> 
         <td>xxx.com </td> 
         <td>激活会员卡的url。 </td>
        </tr> 
        <tr> 
         <td>custom_cell1 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>name </td> 
         <td>是 </td> 
         <td>string（15） </td> 
         <td>见上述示例。 </td> 
         <td>入口名称。 </td>
        </tr> 
        <tr> 
         <td>tips </td> 
         <td>是 </td> 
         <td>string（18） </td> 
         <td>立即查看 </td> 
         <td>入口右侧提示语，6个汉字内。 </td>
        </tr> 
        <tr> 
         <td>url </td> 
         <td>是 </td> 
         <td>string（128） </td> 
         <td>xxx.com </td> 
         <td>入口跳转链接。 </td>
        </tr> 
        <tr> 
         <td>bonus_rule </td> 
         <td>否 </td> 
         <td>json结构 </td> 
         <td>见上述示例 </td> 
         <td>积分规则。用于<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E8.AE.BE.E7.BD.AE.E5.BE.AE.E4.BF.A1.E4.B9.B0.E5.8D.95.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">微信买单功能</a>。 </td>
        </tr> 
        <tr> 
         <td>cost_money_unit </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>消费金额。以分为单位。 </td>
        </tr> 
        <tr> 
         <td>increase_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>对应增加的积分。 </td>
        </tr> 
        <tr> 
         <td>max_increase_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10000 </td> 
         <td>用户单次可获取的积分上限。 </td>
        </tr> 
        <tr> 
         <td>init_increase_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>初始设置积分。 </td>
        </tr> 
        <tr> 
         <td>cost_bonus_unit </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>每使用5积分。 </td>
        </tr> 
        <tr> 
         <td>reduce_money </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>抵扣xx元，（这里以分为单位） </td>
        </tr> 
        <tr> 
         <td>least_money_to_use_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>抵扣条件，满xx元（这里以分为单位）可用。 </td>
        </tr> 
        <tr> 
         <td>max_reduce_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>抵扣条件，单笔最多使用xx积分。 </td>
        </tr> 
        <tr> 
         <td>discount </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>折扣，该会员卡享受的折扣优惠,填10就是九折。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>base_info字段：</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:60px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>logo_url </td> 
         <td>是 </td> 
         <td>string(128) </td> 
         <td><a href="http://mmbiz.qpic.cn/" class="external free" rel="nofollow">http://mmbiz.qpic.cn/</a> </td> 
         <td>卡券的商户logo，建议像素为300*300。 </td>
        </tr> 
        <tr> 
         <td>code_type </td> 
         <td>是 </td> 
         <td>string(16) </td> 
         <td>CODE_TYPE_TEXT </td> 
         <td>Code展示类型，"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示； </td>
        </tr> 
        <tr> 
         <td>brand_name </td> 
         <td>是 </td> 
         <td>string（36） </td> 
         <td>海底捞 </td> 
         <td>商户名字,字数上限为12个汉字。 </td>
        </tr> 
        <tr> 
         <td>title </td> 
         <td>是 </td> 
         <td>string（27） </td> 
         <td>双人套餐100元兑换券 </td> 
         <td>卡券名，字数上限为9个汉字。(建议涵盖卡券属性、服务及金额)。 </td>
        </tr> 
        <tr> 
         <td>color </td> 
         <td>是 </td> 
         <td>string（16） </td> 
         <td>Color010 </td> 
         <td>券颜色。按色彩规范标注填写Color010-Color100。详情见<a href="../19/39f3e3d4d9442ed77aa27257b38eda37.html#.E8.8E.B7.E5.8F.96.E9.A2.9C.E8.89.B2.E5.88.97.E8.A1.A8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">获取颜色列表接口</a> </td>
        </tr> 
        <tr> 
         <td>notice </td> 
         <td>是 </td> 
         <td>string（48） </td> 
         <td>请出示二维码核销卡券 </td> 
         <td>卡券使用提醒，字数上限为16个汉字。 </td>
        </tr> 
        <tr> 
         <td>description </td> 
         <td>是 </td> 
         <td>string（3072） </td> 
         <td>不可与其他优惠同享/n如需团购券发票，请向店员提出要求。 </td> 
         <td>卡券使用说明，字数上限为1024个汉字。 </td>
        </tr> 
        <tr> 
         <td>sku </td> 
         <td>是 </td> 
         <td> Json结构 </td> 
         <td> 见上述示例。 </td> 
         <td>商品信息。 </td>
        </tr> 
        <tr> 
         <td>quantity </td> 
         <td>是 </td> 
         <td>int </td> 
         <td>100000 </td> 
         <td>卡券库存的数量，不支持填写0，上限为100000000。 </td>
        </tr> 
        <tr> 
         <td>date_info </td> 
         <td>是 </td> 
         <td> Json结构 </td> 
         <td> 见上述示例。 </td> 
         <td>使用日期，有效期的信息。 </td>
        </tr> 
        <tr> 
         <td>type </td> 
         <td>是 </td> 
         <td>string </td> 
         <td>DATE_TYPE_FIX_TIME_RANGE 表示固定日期区间，DATE_TYPE_FIX_TERM表示固定时长（自领取后按天算），DATE_TYPE_PERMANENT 表示永久有效。 </td> 
         <td>使用时间的类型，旧文档采用的1和2依然生效。 </td>
        </tr> 
        <tr> 
         <td>begin_timestamp </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>14300000 </td> 
         <td>type为DATE_TYPE_FIX_TIME_RANGE时专用，表示起用时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入。（东八区时间，单位为秒） </td>
        </tr> 
        <tr> 
         <td>end_timestamp </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>15300000 </td> 
         <td>type为DATE_TYPE_FIX_TERM_RANGE时专用，表示结束时间，<font color="#FF0000">建议设置为截止日期的23:59:59过期</font>。（东八区时间，单位为秒） </td>
        </tr> 
        <tr> 
         <td>fixed_term </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>0 </td> 
         <td>type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天内有效，领取后当天有效填写0。（单位为天） </td>
        </tr> 
        <tr> 
         <td>fixed_begin_term </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>15 </td> 
         <td>type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天开始生效。（单位为天） </td>
        </tr> 
        <tr> 
         <td>use_custom_code </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>true </td> 
         <td>是否自定义Code码。填写true或false，默认为false。通常自有优惠码系统的开发者选择自定义Code码，在卡券投放时带入。 </td>
        </tr> 
        <tr> 
         <td>bind_openid </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>true </td> 
         <td>是否指定用户领取，填写true或false。默认为false。 </td>
        </tr> 
        <tr> 
         <td>service_phone </td> 
         <td>否 </td> 
         <td>string（24） </td> 
         <td>40012234 </td> 
         <td>客服电话。 </td>
        </tr> 
        <tr> 
         <td>location_id_list </td> 
         <td>否 </td> 
         <td>array </td> 
         <td>1234，2312 </td> 
         <td>门店位置ID。调用<a href="../19/39f3e3d4d9442ed77aa27257b38eda37.html#POI.E9.97.A8.E5.BA.97.E7.AE.A1.E7.90.86.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">POI门店管理接口</a>获取门店位置ID。 </td>
        </tr> 
        <tr> 
         <td>source </td> 
         <td>否 </td> 
         <td>string（36） </td> 
         <td>大众点评 </td> 
         <td>第三方来源名，例如同程旅游、大众点评。 </td>
        </tr> 
        <tr> 
         <td>custom_url_name </td> 
         <td>否 </td> 
         <td>string（15） </td> 
         <td>立即使用 </td> 
         <td>自定义跳转外链的入口名字。 </td>
        </tr> 
        <tr> 
         <td>custom_url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>"xxxx.com" </td> 
         <td>自定义跳转的URL。 </td>
        </tr> 
        <tr> 
         <td>custom_url_sub_title </td> 
         <td>否 </td> 
         <td>string（18） </td> 
         <td>更多惊喜 </td> 
         <td>显示在入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_name </td> 
         <td>否 </td> 
         <td>string（15） </td> 
         <td>产品介绍 </td> 
         <td>营销场景的自定义入口名称。 </td>
        </tr> 
        <tr> 
         <td>promotion_url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>XXXX.com </td> 
         <td>入口跳转外链的地址链接。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_sub_title </td> 
         <td>否 </td> 
         <td>string（18） </td> 
         <td>卖场大优惠。 </td> 
         <td>显示在营销入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>get_limit </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>1 </td> 
         <td>每人可领券的数量限制。默认值为50。 </td>
        </tr> 
        <tr> 
         <td>can_share </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>false </td> 
         <td>卡券领取页面是否可分享。 </td>
        </tr> 
        <tr> 
         <td>can_give_friend </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>false </td> 
         <td>卡券是否可转赠。 </td>
        </tr> 
        <tr> 
         <td>need_push_on_view </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>false </td> 
         <td>填写true为用户点击进入会员卡时推送事件，默认为false。详情见<a href="../16/28b34ee91675a04cb24853768debded4.html#.E8.BF.9B.E5.85.A5.E4.BC.9A.E5.91.98.E5.8D.A1.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">进入会员卡事件推送</a> </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回说明</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok",
   "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 卡券ID。 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.AD.A5.E9.AA.A4.E4.BA.8C.EF.BC.9A.E8.8E.B7.E5.8F.96.E4.BC.9A.E5.91.98.E5.8D.A1.E5.AE.A1.E6.A0.B8.E7.BB.93.E6.9E.9C"><b>步骤二：获取会员卡审核结果</b></span></h2> 
      <p>调用接口成功创建会员卡后，会由系统自动提交审核，审核结果将在三个工作日内以事件形式告知开发者，同时支持调用接口主动查询卡券状态。 </p> 
      <h3> <span class="mw-headline" id=".E5.AE.A1.E6.A0.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><b>审核事件推送</b></span></h3> 
      <p>生成的卡券通过审核时，微信会把这个事件推送到开发者填写的URL。 </p> 
      <pre>&lt;xml&gt; &lt;ToUserName&gt;&lt;![CDATA[toUser]]&gt;&lt;/ToUserName&gt; 
&lt;FromUserName&gt;&lt;![CDATA[FromUser]]&gt;&lt;/FromUserName&gt; 
&lt;CreateTime&gt;123456789&lt;/CreateTime&gt; 
&lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt; 
&lt;Event&gt;&lt;![CDATA[card_pass_check]]&gt;&lt;/Event&gt;  //不通过为card_not_pass_check
&lt;CardId&gt;&lt;![CDATA[cardid]]&gt;&lt;/CardId&gt; 
&lt;/xml&gt;
</pre> 
      <p>参数说明： </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 发送方帐号（一个OpenID） </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型） </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event </td>
        </tr> 
        <tr> 
         <td> Event </td> 
         <td> 事件类型，card_pass_check(卡券通过审核)、card_not_pass_check（卡券未通过审核） </td>
        </tr> 
        <tr> 
         <td> CardId </td> 
         <td> 卡券ID </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3"><b>查看卡券详情接口</b></span></h3> 
      <p>调用该接口可查询卡券字段详情及卡券所处状态。通过查看返回值中status字段可判断该卡券是否通过审核。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/get?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/get?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  "card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> cardid </td> 
         <td> 是 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode": 0,
   "errmsg": "ok",
   "card": {
       "card_type":  "GROUPON",
           "groupon": {
           "base_info": {
               "status": 1,
               "id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
               "logo_url": "<a href="http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0</a>",
               "appid": "wx588def6b0089dd48",
               "code_type": "CODE_TYPE_TEXT",
               "brand_name": "海底捞",
               "title": "132元双人火锅套餐",
               "sub_title": "",
               "date_info": {
                   "type": DATE_TYPE_FIX_TIME_RANGE,
                   "begin_timestamp": 1397577600,
                   "end_timestamp": 1399910400
               },
               "color": "#3373bb",
               "notice": "使用时向服务员出示此券",
               "service_phone": "020-88888888",
               "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食\n餐前不可打包，餐后未吃完，可打包\n本团购券不限人数，建议2人使用，超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料",
               "use_limit": 1,
               "get_limit": 3,
               "can_share": true,
               "location_id_list"&nbsp;: [123, 12321, 345345]
               "custom_url_name": "立即使用",
               "custom_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a>",
               "custom_url_sub_title": "6个汉字tips",
               "promotion_url_name": "更多优惠",
               "promotion_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a>",
               "source": "大众点评"   
               "sku": {
                   "quantity": 0
               }
           },
           "deal_detail": "以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸菜鱼锅可选）：\n大锅1份 12元\n小锅2份 16元\n以下菜品2选1\n特级肥牛1份 30元\n洞庭鮰鱼卷1份 20元\n其他\n鲜菇猪肉滑1份 18元\n金针菇1份 16元\n黑木耳1份 9元\n娃娃菜1份 8元\n冬瓜1份 6元\n火锅面2个 6元\n欢乐畅饮2位 12元\n自助酱料2位 10元",
       }
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> card_type </td> 
         <td> 卡券类型。 <p>团购券：GROUPON; 折扣券：DISCOUNT; 礼品券：GIFT; 代金券：CASH; 通用券：GENERAL_COUPON; 会员卡：MEMBER_CARD; 景点门票：SCENIC_TICKET； 电影票：MOVIE_TICKET； 飞机票：BOARDING_PASS； 会议门票：MEETING_TICKET； 汽车票：BUS_TICKET; </p> </td>
        </tr> 
        <tr> 
         <td> base_info </td> 
         <td> 基本的卡券数据，见下表，所有卡券通用。 </td>
        </tr> 
        <tr> 
         <td>supply_balance </td> 
         <td>会员卡专属字段，表示是否支持积分，填写true或false，如填写true，积分相关字段均为必填。 </td>
        </tr> 
        <tr> 
         <td>supply_bonus </td> 
         <td>会员卡专属字段，表示否支持储值，填写true或false，如填写true，储值相关字段均为必填。 </td>
        </tr> 
        <tr> 
         <td>bonus_cleared </td> 
         <td>积分清零规则。 </td>
        </tr> 
        <tr> 
         <td>bonus_rules </td> 
         <td>积分规则。 </td>
        </tr> 
        <tr> 
         <td>balance_rules </td> 
         <td>储值规则。 </td>
        </tr> 
        <tr> 
         <td>prerogative </td> 
         <td>会员卡专属字段，表示特权说明。 </td>
        </tr> 
        <tr> 
         <td>bind_old_card_url </td> 
         <td>绑定旧卡的url。 </td>
        </tr> 
        <tr> 
         <td>activate_url </td> 
         <td>激活会员卡。 </td>
        </tr> 
        <tr> 
         <td>need_push_on_view </td> 
         <td>进入会员卡时是否推送事件，填写true或false。 </td>
        </tr> 
        <tr> 
         <td>from </td> 
         <td>飞机票的起点，上限为18个汉字。 </td>
        </tr> 
        <tr> 
         <td>to </td> 
         <td>飞机票的终点，上限为18个汉字。 </td>
        </tr> 
        <tr> 
         <td>flight </td> 
         <td>航班。 </td>
        </tr> 
        <tr> 
         <td>departure_time </td> 
         <td>起飞时间。（Unix时间戳格式） </td>
        </tr> 
        <tr> 
         <td>landing_time </td> 
         <td>降落时间。（Unix时间戳格式） </td>
        </tr> 
        <tr> 
         <td>check_in_url </td> 
         <td>在线值机的链接。 </td>
        </tr> 
        <tr> 
         <td>gate </td> 
         <td>登机口。如发生登机口变更，建议商家实时调用该接口变更。 </td>
        </tr> 
        <tr> 
         <td>boarding_time </td> 
         <td>登机时间，只显示“时分”不显示日期。（Unix时间戳格式） </td>
        </tr> 
        <tr> 
         <td>meeting_detail </td> 
         <td>会议详情。 </td>
        </tr> 
        <tr> 
         <td>map_url </td> 
         <td>会场导览图。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>base_info字段： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>logo_url </td> 
         <td>卡券的商户logo，建议像素为300*300。 </td>
        </tr> 
        <tr> 
         <td>code_type </td> 
         <td>"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示； </td>
        </tr> 
        <tr> 
         <td>brand_name </td> 
         <td>商户名字（填写直接提供服务的商户名，第三方商户名填写在source字段）。 </td>
        </tr> 
        <tr> 
         <td>title </td> 
         <td>卡券名。 </td>
        </tr> 
        <tr> 
         <td>sub_title </td> 
         <td>卡券名的副标题。 </td>
        </tr> 
        <tr> 
         <td>color </td> 
         <td>卡券的背景颜色。 </td>
        </tr> 
        <tr> 
         <td>notice </td> 
         <td>使用提醒，字数上限为16个汉字。 </td>
        </tr> 
        <tr> 
         <td>description </td> 
         <td>使用说明。长文本描述。 </td>
        </tr> 
        <tr> 
         <td>date_info </td> 
         <td>使用日期，有效期的信息。 </td>
        </tr> 
        <tr> 
         <td>type </td> 
         <td>使用时间的类型。DATE_TYPE_FIX_TIME_RANGE为固定日期区间，DATE_TYPE_FIX_TERM为固定时长（自领取后按天算）,DATE_TYPE_PERMANENT 表示永久有效。 </td>
        </tr> 
        <tr> 
         <td>begin_timestamp </td> 
         <td>type为DATE_TYPE_FIX_TIME_RANGE时专用，表示起用时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入，下同。（单位为秒） </td>
        </tr> 
        <tr> 
         <td>end_timestamp </td> 
         <td>type为DATE_TYPE_FIX_TIME_RANGE时专用，表示结束时间。（单位为秒） </td>
        </tr> 
        <tr> 
         <td>fixed_term </td> 
         <td>type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天内有效，领取后当天有效填写0。（单位为天） </td>
        </tr> 
        <tr> 
         <td>fixed_begin_term </td> 
         <td>type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天开始生效。（单位为天） </td>
        </tr> 
        <tr> 
         <td>sku </td> 
         <td>商品信息 </td>
        </tr> 
        <tr> 
         <td>quantity </td> 
         <td>卡券库存的数量，不支持填写0。（上限为100000000） </td>
        </tr> 
        <tr> 
         <td>location_id_list </td> 
         <td>门店位置ID。 </td>
        </tr> 
        <tr> 
         <td>use_custom_code </td> 
         <td>是否自定义Code码。填写true或false，默认为false。 </td>
        </tr> 
        <tr> 
         <td>bind_openid </td> 
         <td>是否指定用户领取，填写true或false。默认为否。 </td>
        </tr> 
        <tr> 
         <td>can_share </td> 
         <td>卡券是否可转赠，填写true或false,true代表可转赠。默认为true。 </td>
        </tr> 
        <tr> 
         <td>service_phone </td> 
         <td>客服电话。 </td>
        </tr> 
        <tr> 
         <td>source </td> 
         <td>第三方来源名，例如同程旅游、大众点评。 </td>
        </tr> 
        <tr> 
         <td>custom_url_name </td> 
         <td>商户自定义入口名称。 </td>
        </tr> 
        <tr> 
         <td>custom_url </td> 
         <td>商户自定义入口跳转外链的地址链接,跳转页面内容需与自定义cell名称保持匹配。 </td>
        </tr> 
        <tr> 
         <td>custom_url_sub_title </td> 
         <td>显示在入口右侧的tips，长度限制在6个汉字内。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_name </td> 
         <td>营销场景的自定义入口。 </td>
        </tr> 
        <tr> 
         <td>promotion_url </td> 
         <td>入口跳转外链的地址链接。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_sub_title </td> 
         <td>显示在营销入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>custom_url_name </td> 
         <td>商户自定义入口名称。 </td>
        </tr> 
        <tr> 
         <td>status </td> 
         <td>“CARD_STATUS_NOT_VERIFY”,待审核；“CARD_STATUS_VERIFY_FALL”,审核失败；“CARD_STATUS_VERIFY_OK”，通过审核；“CARD_STATUS_USER_DELETE”，卡券被用户删除；“CARD_STATUS_USER_DISPATCH”，在公众平台投放过的卡券 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E6.B5.8B.E8.AF.95.E7.99.BD.E5.90.8D.E5.8D.95"><b>设置测试白名单</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>由于卡券有审核要求，为方便公众号调试，可以设置十个测试帐号，这些帐号可领取未通过审核的卡券，体验整个流程。 </p>
      <p><b>开发者注意事项</b> </p>
      <p>1.同时支持“openid”、“username”两种字段设置白名单，总数上限为10个。 </p>
      <p>2.设置测试白名单接口为全量设置，即测试名单发生变化时需调用该接口重新传入所有测试人员的ID. </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/testwhitelist/set?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/testwhitelist/set?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <pre>{
  "openid": [
      "o1Pj9jmZvwSyyyyyyBa4aULW2mA", 
      "o1Pj9jmZvxxxxxxxxxULW2mA"
               ],
  "username": [
      "afdvvf",
      "abcd"
                ]
 }

</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>openid </td> 
         <td>否 </td> 
         <td>string(20) </td> 
         <td>o1Pj9jmZvwSyyyyyyBa4aULW2mA </td> 
         <td>测试的openid列表。 </td>
        </tr> 
        <tr> 
         <td>username </td> 
         <td>否 </td> 
         <td>string（32） </td> 
         <td>eddy </td> 
         <td>测试的微信号列表。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回说明</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息。 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.AD.A5.E9.AA.A4.E4.B8.89.EF.BC.9A.E6.8A.95.E6.94.BE.E4.BC.9A.E5.91.98.E5.8D.A1"><b>步骤三：投放会员卡</b></span></h2> 
      <p>支持开发者调用接口通过二维码、JS-SDK、群发消息等多种方式投放会员卡。 </p>
      <p><b>特别注意</b> </p>
      <p><font color="#FF0000"> 开发者调用接口投放的会员卡为无会员信息的“卡套”，会员卡编号、积分、余额等信息需在用户领取会员卡后调用<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E4.BA.8C.EF.BC.9A.E6.BF.80.E6.B4.BB.2F.E7.BB.91.E5.AE.9A.E4.BC.9A.E5.91.98.E5.8D.A1" class="external text" rel="nofollow">激活/绑定会员卡接口</a>更新上。 </font></p>
      <p><font color="#FF0000">调用激活/绑定会员卡接口的凭证为Code码及卡券ID，开发者需在调用投放会员卡时通过接口或领取卡券事件记录Code码与会员的关系。 </font> </p> 
      <h3> <span class="mw-headline" id=".E5.88.9B.E5.BB.BA.E4.BA.8C.E7.BB.B4.E7.A0.81.E6.8E.A5.E5.8F.A3"><b>创建二维码接口</b></span></h3> 
      <p>开发者可调用该接口生成一张卡券二维码供用户扫码后添加卡券到卡包。 </p>
      <p>自定义Code码的卡券调用接口时，post数据中需指定code，非自定义code不需指定，指定openid同理。指定后的二维码只能被用户扫描领取一次。 </p>
      <p>注：该接口仅支持卡券功能，供已开通卡券功能权限的商户（订阅号、服务号）调用。 已认证服务号的商户也可使用高级接口中<a href="../18/167e7d94df85d8389df6c94a7a8f78ba.html" class="external text" rel="nofollow">生成带参数的二维码接口</a>生成卡券二维码。 </p>
      <p>获取二维码ticket后，开发者可用<a href="../18/167e7d94df85d8389df6c94a7a8f78ba.html" class="external text" rel="nofollow">通过ticket换取二维码接口</a>换取二维码图片详情。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/qrcode/create?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/qrcode/create?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> 开发者可以设置扫描二维码领取单张卡券，此时POST数据为： </p> 
      <pre> {
"action_name": "QR_CARD", 
"expire_seconds": 1800,
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", 
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"is_unique_code": false ,
"outer_id"&nbsp;: 1
  }
 }
}
</pre> 
      <p>当开发者设置扫描二维码领取多张卡券，此时POST数据为： </p> 
      <pre>{
"action_name": "QR_MULTIPLE_CARD", 
"action_info": {
"multiple_card": {
"card_list": [
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo88",
"code":"2392583481"
}, 
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo98",
"code":"2392583482"
}
]
}
}
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> 110201201245 </td> 
         <td> 卡券Code码,use_custom_code字段为true的卡券必须填写，非自定义code不必填写。。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> oXch-jkrxp42VQu8ldweCwDt97qo </td> 
         <td> 指定领取者的openid，只有该用户能领取。bind_openid字段为true的卡券必须填写，非指定openid不必填写。 </td>
        </tr> 
        <tr> 
         <td> expire_seconds </td> 
         <td> 否 </td> 
         <td> unsigned int </td> 
         <td> 60 </td> 
         <td> 指定二维码的有效时间，范围是60 ~ 1800秒。不填默认为永久有效。 </td>
        </tr> 
        <tr> 
         <td> is_unique_code </td> 
         <td> 否 </td> 
         <td> bool </td> 
         <td> false </td> 
         <td> 指定下发二维码，生成的二维码随机分配一个code，领取后不可再次扫描。填写true或false。默认false。 </td>
        </tr> 
        <tr> 
         <td> outer_id </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 12 </td> 
         <td> 领取场景值，用于领取渠道的数据统计，默认值为0，字段类型为整型，长度限制为60位数字。用户领取卡券后触发的<a href="../16/28b34ee91675a04cb24853768debded4.html#.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">事件推送</a>中会带上此自定义场景值。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "ticket":      "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==",//获取ticket后需调用换取二维码接口获取二维码图片，详情见字段说明。
 "expire_seconds": 1800,
 "url": "<a href="http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o" class="external free" rel="nofollow">http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o</a> ",
 "show_qrcode_url": " <a href="https://mp.weixin.qq.com/cgi-bin/showqrcode" class="external free" rel="nofollow">https://mp.weixin.qq.com/cgi-bin/showqrcode</a>?  ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0czVzRlSWpsamlyM2plWTNKVktvAAIE6SfgVQMEgDPhAQ%3D%3D"
 }
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> ticket </td> 
         <td> 获取的二维码ticket，凭借此ticket调用<a href="../18/167e7d94df85d8389df6c94a7a8f78ba.html" class="external text" rel="nofollow">通过ticket换取二维码接口</a>可以在有效时间内换取二维码。 </td>
        </tr> 
        <tr> 
         <td>url </td> 
         <td>二维码图片解析后的地址，开发者可根据该地址自行生成需要的二维码图片 </td>
        </tr> 
        <tr> 
         <td>show_qrcode_url </td> 
         <td>二维码显示地址，点击后跳转二维码页面 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.B7.BB.E5.8A.A0.E5.8D.A1.E5.88.B8JS-SDK"><b>添加卡券JS-SDK</b></span></h3> 
      <p>微信 JS-SDK 仅支持在微信内置浏览器中使用,其他浏览器调用无效。微信提供addCard接口供商户前端网页调用,用于将一张或多张卡券添加到用户卡包。详情见<a href="../11/74ad127cc054f6b80759c40f77ec03db.html#.E6.89.B9.E9.87.8F.E6.B7.BB.E5.8A.A0.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">批量添加卡券接口</a>。 </p>
      <p><a href="#" class="image"><img alt="添加JS-SDK.png" src="../static/assets/ff82fd2ac01efc392c30a657e37f896a.png" width="844" height="440"></a> </p> 
      <h3> <span class="mw-headline" id=".E9.80.9A.E8.BF.87.E5.8D.A1.E5.88.B8.E8.B4.A7.E6.9E.B6.E6.8A.95.E6.94.BE.E5.8D.A1.E5.88.B8"><b>通过卡券货架投放卡券</b></span></h3> 
      <p><b>卡券货架简介</b> </p>
      <p>卡券货架支持开发者通过调用接口生成一个卡券领取H5页面，并获取页面链接，进行卡券投放动作。接口详情见<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E5.88.9B.E5.BB.BA.E8.B4.A7.E6.9E.B6.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">创建卡券货架接口</a> </p>
      <p><a href="#" class="image"><img alt="卡券货架.png" src="../static/assets/69da938facf06f2025ec136f78902e56.png" width="646" height="378"></a> </p> 
      <h3> <span class="mw-headline" id=".E7.BE.A4.E5.8F.91.E5.8D.A1.E5.88.B8"><b>群发卡券</b></span></h3> 
      <p><font color="#FF0000"> 请开发者特别注意，目前群发卡券接口仅支持投放非自定义Code码的卡券，非自定义code的开发者可以选择提前用<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E5.AF.BC.E5.85.A5code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">导入code接口</a>将code导入至微信服务器，从而获得和非自定义code相同的群发能力。 </font> </p>
      <p><br> <b>图文消息群发卡券</b> </p>
      <p>支持开发者调用该接口获取卡券嵌入图文消息的标准格式代码，将返回代码填入<a href="../15/40b6865b893947b764e2de8e4a1fb55f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E6.96.87.E6.B6.88.E6.81.AF.E7.B4.A0.E6.9D.90.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91" class="external text" rel="nofollow">上传图文素材接口</a>中content字段，即可获取嵌入卡券的图文消息素材。 </p>
      <p>特别注意：目前该接口仅支持填入非自定义code的卡券,非自定义code的开发者可以选择提前用<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E5.AF.BC.E5.85.A5code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">导入code接口</a>将code导入至微信服务器。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/mpnews/gethtml?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/mpnews/gethtml?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> cardid </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
"content":"&lt;iframeclass=\"res_iframecard_iframejs_editor_card\"data-src=\"http: \/\/mp.weixin.qq.com\/bizmall\/appmsgcard?action=show&amp;biz=MjM5OTAwODk4MA%3D%3D&amp;cardid=p1Pj9jnXTLf2nF7lccYScFUYqJ0&amp;wechat_card_js=1#wechat_redirect\"&gt;"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> content </td> 
         <td> 返回一段html代码，可以直接嵌入到图文消息的正文里。即可以把这段代码嵌入到<a href="../15/40b6865b893947b764e2de8e4a1fb55f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E6.96.87.E6.B6.88.E6.81.AF.E7.B4.A0.E6.9D.90.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91" class="external text" rel="nofollow">上传图文消息素材接口</a>中的content字段里。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>根据分组群发卡券消息</b> </p>
      <p>支持调用该接口向指定分组的用户群发卡券消息。详情见<a href="../15/40b6865b893947b764e2de8e4a1fb55f.html#.E6.A0.B9.E6.8D.AE.E5.88.86.E7.BB.84.E8.BF.9B.E8.A1.8C.E7.BE.A4.E5.8F.91.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91" class="external text" rel="nofollow">根据分组进行群发接口</a> </p>
      <p><font color="#FF0000">特别注意：目前该接口仅支持填入非自定义code的卡券,非自定义code的开发者可以选择提前用<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E5.AF.BC.E5.85.A5code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">导入code接口</a>将code导入至微信服务器。</font> </p>
      <p><b>根据OpenID列表群发卡券消息</b> </p>
      <p>支持根据OpenID群发原生卡券。订阅号不可用，服务号认证后具备接口权限。详情见<a href="../15/40b6865b893947b764e2de8e4a1fb55f.html#.E6.A0.B9.E6.8D.AEOpenID.E5.88.97.E8.A1.A8.E7.BE.A4.E5.8F.91.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8D.E5.8F.AF.E7.94.A8.EF.BC.8C.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.8F.AF.E7.94.A8.E3.80.91" class="external text" rel="nofollow">根据OpenID列表群发接口</a> </p>
      <p><font color="#FF0000">特别注意：目前该接口仅支持填入非自定义code的卡券,非自定义code的开发者可以选择提前用<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E5.AF.BC.E5.85.A5code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">导入code接口</a>将code导入至微信服务器。</font> </p>
      <p><b>客服消息下发卡券</b> </p>
      <p>支持开发者调用该接口下发卡券。订阅号不可用，服务号认证后可用。详情见<a href="../11/c88c270ae8935291626538f9c64bd123.html#.E5.AE.A2.E6.9C.8D.E6.8E.A5.E5.8F.A3-.E5.8F.91.E6.B6.88.E6.81.AF" class="external text" rel="nofollow">客服接口-发消息</a> </p>
      <p><font color="#FF0000">特别注意：目前该接口仅支持填入非自定义code的卡券,非自定义code的开发者可以选择提前用<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E5.AF.BC.E5.85.A5code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">导入code接口</a>将code导入至微信服务器。</font> </p>
      <p><b>预览接口</b> </p>
      <p>支持开发者调用该接口下发卡券。订阅号不可用，服务号认证后可用。详情见<a href="../15/40b6865b893947b764e2de8e4a1fb55f.html#.E9.A2.84.E8.A7.88.E6.8E.A5.E5.8F.A3.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91" class="external text" rel="nofollow">客服接口-发消息</a> </p> 
      <h3> <span class="mw-headline" id=".E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><b>领取事件推送</b></span></h3> 
      <p>用户在领取卡券时，微信会把这个事件推送到开发者填写的URL。 推送XML数据包示例： </p> 
      <pre>&lt;xml&gt; &lt;ToUserName&gt;&lt;![CDATA[toUser]]&gt;&lt;/ToUserName&gt; 
&lt;FromUserName&gt;&lt;![CDATA[FromUser]]&gt;&lt;/FromUserName&gt; 
&lt;FriendUserName&gt;&lt;![CDATA[FriendUser]]&gt;&lt;/FriendUserName&gt; 
&lt;CreateTime&gt;123456789&lt;/CreateTime&gt; 
&lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt; 
&lt;Event&gt;&lt;![CDATA[user_get_card]]&gt;&lt;/Event&gt; 
&lt;CardId&gt;&lt;![CDATA[cardid]]&gt;&lt;/CardId&gt; 
&lt;IsGiveByFriend&gt;1&lt;/IsGiveByFriend&gt;
&lt;UserCardCode&gt;&lt;![CDATA[12312312]]&gt;&lt;/UserCardCode&gt;
&lt;OuterId&gt;0&lt;/OuterId&gt;
&lt;/xml&gt;
</pre> 
      <p>参数说明： </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号。 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 领券方帐号（一个OpenID）。 </td>
        </tr> 
        <tr> 
         <td> FriendUserName </td> 
         <td> 赠送方账号（一个OpenID），"IsGiveByFriend”为1时填写该参数。 </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型）。 </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event </td>
        </tr> 
        <tr> 
         <td> Event </td> 
         <td> 事件类型，user_get_card(用户领取卡券)。 </td>
        </tr> 
        <tr> 
         <td> CardId </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> IsGiveByFriend </td> 
         <td> 是否为转赠，1代表是，0代表否。 </td>
        </tr> 
        <tr> 
         <td> UserCardCode </td> 
         <td> code序列号。自定义code及非自定义code的卡券被领取后都支持事件推送。 </td>
        </tr> 
        <tr> 
         <td> OldUserCardCode </td> 
         <td> 转赠前的code序列号。 </td>
        </tr> 
        <tr> 
         <td> OuterId </td> 
         <td> 领取场景值，用于领取渠道数据统计。可在生成二维码接口及添加JS API接口中自定义该字段的整型值。 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.8A.95.E6.94.BE.E6.B8.A0.E9.81.93.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><b>投放渠道数据统计</b></span></h3> 
      <p>为方便开发者统计各渠道的卡券投放数据，新增字段outer_id。将不同设值的outer_id填入card_ext的json结构中，当用户领取卡券时会将相应设值的outer_id带入<a href="../16/28b34ee91675a04cb24853768debded4.html#.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">领取事件</a>中，推送至开发者服务器。 </p>
      <p>示例： 在二维码投放方式中设置outer_id为1 </p> 
      <pre>{
"action_name": "QR_CARD", 
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", 
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"expire_seconds": "1800"，
"is_unique_code": false ,
"outer_id"&nbsp;: 1
  }
 }
}
</pre> 
      <p><br> 领取事件XML文件 </p> 
      <pre>&lt;xml&gt; &lt;ToUserName&gt;&lt;![CDATA[toUser]]&gt;&lt;/ToUserName&gt; 
&lt;FromUserName&gt;&lt;![CDATA[FromUser]]&gt;&lt;/FromUserName&gt; 
&lt;FriendUserName&gt;&lt;![CDATA[FriendUser]]&gt;&lt;/FriendUserName&gt; 
&lt;CreateTime&gt;123456789&lt;/CreateTime&gt; 
&lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt; 
&lt;Event&gt;&lt;![CDATA[user_get_card]]&gt;&lt;/Event&gt; 
&lt;CardId&gt;&lt;![CDATA[cardid]]&gt;&lt;/CardId&gt; 
&lt;IsGiveByFriend&gt;1&lt;/IsGiveByFriend&gt;
&lt;UserCardCode&gt;&lt;![CDATA[12312312]]&gt;&lt;/UserCardCode&gt;
&lt;OuterId&gt;1&lt;/OuterId&gt;
&lt;/xml&gt;
</pre> 
      <h2> <span class="mw-headline" id=".E6.AD.A5.E9.AA.A4.E5.9B.9B.EF.BC.9A.E6.BF.80.E6.B4.BB.2F.E7.BB.91.E5.AE.9A.E4.BC.9A.E5.91.98.E5.8D.A1"><b>步骤四：激活/绑定会员卡</b></span></h2> 
      <p>当用户领取会员卡“卡套”后，支持调用该接口对会员卡进行激活或绑定，并设置会员信息的初始值，如积分、余额、会员卡编号。 </p>
      <p>目前，微信会员卡支持三种激活方式，分别是接口激活、一键激活和自动激活。 </p>
      <p>开发者注意事项 </p>
      <p>1.创建会员卡时需设置会员卡被领取后呈现的激活/绑定入口名称，并支持跳转外链填写用户信息，当用户完成激活信息填写后调用激活/绑定会员接口完成会员信息的更新。若无需用户填写会员信息，可在接收到领取事件通知时直接调用该接口完成激活。 </p>
      <p>2.激活/绑定会员卡需传入用户领取时获取的Code码，将该Code码对应设置会员卡编号membership_number。特别注意，用户领取时获取的Code码不显示，会员卡页面仅显示开发者调用该接口传入的会员卡编号membership_number。（membership_number可与Code码等值） </p>
      <p><a href="#" class="image"><img alt="会员卡激活流程.png" src="../static/assets/835204bb7db48c02d8ab48f7c32f3417.png" width="1019" height="641"></a> </p> 
      <h3> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E6.BF.80.E6.B4.BB"><b>接口激活</b></span></h3> 
      <p><b>激活方式说明</b> </p>
      <p>接口激活通常需要开发者开发一个用于用户填写资料的H5页面。通常有两种激活流程，第一种是用户必须填写资料后才能领卡，领卡后开发者调用激活接口为用户激活会员卡； 另一种是用户可以先领取会员卡，点击激活会员卡跳转至开发者设置的资料填写页面，填写完成后开发者调用激活接口为用户激活会员卡。 </p>
      <p><br> <b>接口详情</b> </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/membercard/activate?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/membercard/activate?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <pre>{
  "init_bonus": 100,
  "init_balance": 200,
  "membership_number": "AAA00000001",
  "code": "12312313",
  "card_id": "xxxx_card_id",
  "init_custom_field_value1": "xxxxx"
 }
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>membership_number </td> 
         <td>是 </td> 
         <td>string(20) </td> 
         <td>357898858 </td> 
         <td>会员卡编号，由开发者填入，作为序列号显示在用户的卡包里。可与Code码保持等值。 </td>
        </tr> 
        <tr> 
         <td>code </td> 
         <td>是 </td> 
         <td>string(20) </td> 
         <td>1231123 </td> 
         <td>创建会员卡时获取的初始code。 </td>
        </tr> 
        <tr> 
         <td>activate_begin_time </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>1397577600 </td> 
         <td>激活后的有效起始时间。若不填写默认以创建时的 data_info 为准。Unix时间戳格式。 </td>
        </tr> 
        <tr> 
         <td>activate_end_time </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>1422724261 </td> 
         <td>激活后的有效截至时间。若不填写默认以创建时的 data_info 为准。Unix时间戳格式。 </td>
        </tr> 
        <tr> 
         <td>init_bonus </td> 
         <td>否 </td> 
         <td>string（3072） </td> 
         <td>持白金会员卡到店消费，可享8折优惠。 </td> 
         <td>初始积分，不填为0。 </td>
        </tr> 
        <tr> 
         <td>init_balance </td> 
         <td>否 </td> 
         <td>string（3072） </td> 
         <td>持白金会员卡到店消费，可享8折优惠。 </td> 
         <td>初始余额，不填为0。 </td>
        </tr> 
        <tr> 
         <td>init_custom_field_value1 </td> 
         <td>否 </td> 
         <td>string（12） </td> 
         <td>白银 </td> 
         <td>创建时字段custom_field1定义类型的初始值，限制为4个汉字，12字节。 </td>
        </tr> 
        <tr> 
         <td>init_custom_field_value2 </td> 
         <td>否 </td> 
         <td>string（12） </td> 
         <td>9折 </td> 
         <td>创建时字段custom_field1定义类型的初始值，限制为4个汉字，12字节。 </td>
        </tr> 
        <tr> 
         <td>init_custom_field_value3 </td> 
         <td>否 </td> 
         <td>string（12） </td> 
         <td>200 </td> 
         <td>创建时字段custom_field1定义类型的初始值，限制为4个汉字，12字节。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回说明</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok"
 }
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息。 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E4.B8.80.E9.94.AE.E5.BC.80.E5.8D.A1"><b>一键开卡</b></span></h3> 
      <p>一键激活是微信提供的快速便捷的激活方案，用该种激活方式的会员卡，用户领取时点击“激活会员卡”会跳转至微信原生的资料填写页面，微信会自动拉取该用户之前填写过的开卡信息，用户无需重复填写， 同时避免了手机号验证的过程，从而实现一键激活的目的，提高了开卡率。具体流程如下图： </p>
      <p><a href="#" class="image"><img alt="一键激活.png" src="../static/assets/ee7a79912d90f143b186baaeae91b055.png" width="690" height="374"></a> </p>
      <p><b>步骤一：在创建接口填入wx_activate字段</b> </p>
      <p><b>开发者注意事项</b> </p>
      <p>1.填入了自动激活auto_activate字段，激活链接activate_url和一键开卡接口设置都会失效； </p>
      <p>2.若同时传入了activate_url，则一键开卡接口设置会失效； </p>
      <p>3.建议开发者activate_url auto_activate和wx_activate只填写一项。 </p>
      <p><b>接口说明</b> </p>
      <p>设置微信一键开卡功能，现支持在创建会员卡时填入指定字段指定要一键开卡，member_card中增加"wx_activate": true。 详情请见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E5.88.9B.E5.BB.BA.E4.BC.9A.E5.91.98.E5.8D.A1" class="external text" rel="nofollow">创建会员卡接口</a> </p>
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> member_card </td> 
         <td> </td> 
         <td> </td>
        </tr> 
        <tr> 
         <td> wx_activate </td> 
         <td> 否 </td> 
         <td> 填写true or false </td>
        </tr> 
       </tbody>
      </table> 
      <p>POST数据示例： </p> 
      <pre>{
      "card_id":"pbLatjl-h7zjEq-Pljma29yXGNCU",
      "member_card": {        
                 "wx_activate"&nbsp;: true
      }
}
</pre> 
      <p><br> <b>步骤二：设置开卡字段接口</b> </p>
      <p>支持开发者自定义开卡字段，具体说明如下： </p>
      <p><a href="#" class="image"><img alt="一键激活字段设置.png" src="../static/assets/e7abcf4657d6fd90d14cdb5d5ec4b4de.png" width="420" height="374"></a> </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/membercard/activateuserform/set?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/membercard/activateuserform/set?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <pre>{
   "card_id": "pbLatjpFZHzA0mv6FINEg6M9i2x0",
   "required_form": {
       "common_field_id_list": [
           "USER_FORM_INFO_FLAG_MOBILE",
           "USER_FORM_INFO_FLAG_LOCATION",
           "USER_FORM_INFO_FLAG_BIRTHDAY"
       ],
       "custom_field_list": [
           "喜欢的食物"
       ]
   },
   "optional_form": {
       "common_field_id_list": [
           "USER_FORM_INFO_FLAG_EMAIL"
       ],
       "custom_field_list": [
           "喜欢的电影"
       ]
   }
}
</pre> 
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>card_id </td> 
         <td>是 </td> 
         <td>string(32) </td> 
         <td>pfK3QtyBapdxunUQfLRYMJqPrtII </td> 
         <td>卡券ID。 </td>
        </tr> 
        <tr> 
         <td>required_form </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例。 </td> 
         <td>会员卡激活时的必填选项。 </td>
        </tr> 
        <tr> 
         <td>optional_form </td> 
         <td>否 </td> 
         <td>Json结构，见上述示例。 </td> 
         <td>见上述示例 </td> 
         <td>会员卡激活时的选填项。 </td>
        </tr> 
        <tr> 
         <td>common_field_id_list </td> 
         <td>否 </td> 
         <td>string(32) </td> 
         <td>USER_FORM_INFO_FLAG_MOBILE </td> 
         <td>微信格式化的选项类型。见以下列表。 </td>
        </tr> 
        <tr> 
         <td>custom_field_list </td> 
         <td>否 </td> 
         <td>string(24) </td> 
         <td>喜欢的家具风格 </td> 
         <td>自定义选项名称。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>common_field_id_list，支持开发者使用以下选项类型 </p>
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_MOBILE </td> 
         <td> 手机号 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_NAME </td> 
         <td> 姓名 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_BIRTHDAY </td> 
         <td> 生日 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_IDCARD </td> 
         <td> 身份证 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_EMAIL </td> 
         <td> 邮箱 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_DETAIL_LOCATION </td> 
         <td> 详细地址 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_EDUCATION_BACKGROUND </td> 
         <td> 教育背景 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_CAREER </td> 
         <td> 职业 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_INDUSTRY </td> 
         <td> 行业 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_INCOME </td> 
         <td> 收入 </td>
        </tr> 
        <tr> 
         <td> USER_FORM_INFO_FLAG_HABIT </td> 
         <td> 兴趣爱好 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>步骤三：接收会员信息事件通知</b> </p>
      <p>用户填写、提交资料后，会有事件推送给商家，开发者可以在接收到事件通知后调用激活接口，传入会员卡号、初始积分等信息或者调用拉取会员信息接口获取会员信息，进行会员管理。 </p>
      <p><b>推送XML数据包示例</b> </p> 
      <pre>  &lt;/xml&gt;
  &lt;ToUserName&gt; &lt;![CDATA[gh_3fcea188bf78]]&gt;&lt;/ToUserName&gt;
  &lt;FromUserName&gt;&lt;![CDATA[obLatjlaNQKb8FqOvt1M1x1lIBFE]]&gt;&lt;/FromUserName&gt;
  &lt;CreateTime&gt;1432668700&lt;/CreateTime&gt;
  &lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt;
  &lt;Event&gt;&lt;![CDATA[submit_membercard_user_info]]&gt;&lt;/Event&gt;
  &lt;CardId&gt;&lt;![CDATA[pbLatjtZ7v1BG_ZnTjbW85GYc_E8]]&gt;&lt;/CardId&gt;
  &lt;UserCardCode&gt;&lt;![CDATA[018255396048]]&gt;&lt;/UserCardCode&gt;
  &lt;/xml&gt;
</pre> 
      <p><br> <b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 发送方帐号（一个OpenID） </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型） </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event </td>
        </tr> 
        <tr> 
         <td> CardId </td> 
         <td> 卡券ID </td>
        </tr> 
        <tr> 
         <td> UserCardCode </td> 
         <td> 卡券Code码 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>步骤四：激活会员卡接口</b> </p>
      <p>开发者可以在接收到事件通知后调用激活接口，传入会员卡号、初始积分等信息或者调用拉取会员信息接口获取会员信息，详情请见：<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E5.9B.9B.EF.BC.9A.E6.BF.80.E6.B4.BB.2F.E7.BB.91.E5.AE.9A.E4.BC.9A.E5.91.98.E5.8D.A1" class="external text" rel="nofollow">激活会员卡接口</a> </p>
      <p><br> <b>步骤五：拉取会员信息接口</b> </p>
      <p><b>接口说明</b> </p>
      <p>支持开发者根据CardID和Code查询会员信息。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
   "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8",
   "code": "916679873278"
}
</pre> 
      <p><b>返回数据</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "openid": "obLatjjwDolFj******wNqRXw",
 "nickname": "*******",
 "membership_number": "658*****445",
 "bonus": 995,
 "sex": "MALE",
 "user_info": {
   "common_field_list": [
     {
       "name": "USER_FORM_INFO_FLAG_MOBILE",
       "value": "15*****518"
     },
     {
       "name": "USER_FORM_INFO_FLAG_NAME",
       "value": "HK"
     },
     {
       "name": "USER_FORM_INFO_FLAG_EDUCATION_BACKGROUND",
       "value": "研究生"
     }
   ],
   "custom_field_list": []
 },
 "user_card_status": "NORMAL"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 用户在本公众号内唯一识别码 </td>
        </tr> 
        <tr> 
         <td> nickname </td> 
         <td> 用户昵称 </td>
        </tr> 
        <tr> 
         <td> bonus </td> 
         <td> 积分信息 </td>
        </tr> 
        <tr> 
         <td> balance </td> 
         <td> 余额信息 </td>
        </tr> 
        <tr> 
         <td> sex </td> 
         <td> 用户性别 </td>
        </tr> 
        <tr> 
         <td> user_info </td> 
         <td> 会员信息 </td>
        </tr> 
        <tr> 
         <td> custom_field_list </td> 
         <td> 开发者设置的会员卡会员信息类目，如等级。 </td>
        </tr> 
        <tr> 
         <td> name </td> 
         <td> 会员信息类目名称 </td>
        </tr> 
        <tr> 
         <td> value </td> 
         <td> 会员卡信息类目值，比如等级值等 </td>
        </tr> 
        <tr> 
         <td> user_card_status </td> 
         <td> 当前用户的会员卡状态，NORMAL 正常 EXPIRE 已过期 GIFTING 转赠中 GIFT_SUCC 转赠成功 GIFT_TIMEOUT 转赠超时 DELETE 已删除，UNAVAILABLE 已失效 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E8.87.AA.E5.8A.A8.E6.BF.80.E6.B4.BB"><b>自动激活</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>设置会员卡自动激活功能，需在创建会员卡时填入指定字段，base_info中增加"auto_activate": true，获取cardid。 详情请见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E5.88.9B.E5.BB.BA.E4.BC.9A.E5.91.98.E5.8D.A1" class="external text" rel="nofollow">创建会员卡接口</a> </p>
      <p>值得注意的是，传入自动激活字段auto_activate之后，一键激活设置和接口激活设置的激活url均不再显示，用户领取卡片之后，系统自动帮用户激活，积分、储值等自定义显示信息均为0，开发者可以通过<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E4.BA.94.EF.BC.9A.E6.9B.B4.E6.96.B0.E4.BC.9A.E5.91.98.E4.BF.A1.E6.81.AF" class="external text" rel="nofollow">更新会员信息接口</a>更新用户会员数据。 </p>
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> member_card </td> 
         <td> </td> 
         <td> </td>
        </tr> 
        <tr> 
         <td> auto_activate </td> 
         <td> 否 </td> 
         <td> 填写true or false </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.AD.A5.E9.AA.A4.E4.BA.94.EF.BC.9A.E6.9B.B4.E6.96.B0.E4.BC.9A.E5.91.98.E4.BF.A1.E6.81.AF"><b>步骤五：更新会员信息</b></span></h2> 
      <p>当会员持卡消费后，支持开发者调用该接口更新会员信息。会员卡交易后的每次信息变更需通过该接口通知微信，便于后续消息通知及其他扩展功能。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/membercard/updateuser?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/membercard/updateuser?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p>可以传入积分、余额的差值 </p> 
      <pre>{
 "code": "12312313",
 "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
 "record_bonus": "消费30元，获得3积分",
 "add_bonus": 3,//可以传入积分增减的差值
 "add_balance": -3000,//可以传入余额本次增减的差值
 "record_balance": "购买焦糖玛琪朵一杯，扣除金额30元。",
 "custom_field_value1": "xxxxx",
}
</pre> 
      <p>或者直接传入积分、余额的全量值 </p> 
      <pre>{
 "code": "12312313",
 "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
 "record_bonus": "消费30元，获得3积分",
 "bonus": 3000,//可以传入第三方系统记录的积分全量值
 "balance": 3000,//可以传入第三方系统记录的余额全量值
 "record_balance": "购买焦糖玛琪朵一杯，扣除金额30元。",
 "custom_field_value1": "xxxxx",
}
</pre> 
      <p><font color="#FF0000"> 值得注意的是，如果开发者做不到实时同步积分、余额至微信端，我们强烈建议开发者可以在每天的固定时间点变更积分，一天不超过三次。当传入的积分值与之前无变化时（add_bonus=0或者传入的bonus=原来的bonus），不会有积分变动通知。 </font> </p>
      <p>参数说明： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>code </td> 
         <td>是 </td> 
         <td>string(20) </td> 
         <td>1231123 </td> 
         <td>卡券Code码。 </td>
        </tr> 
        <tr> 
         <td>card_id </td> 
         <td>是 </td> 
         <td>string（32） </td> 
         <td>p1Pj9jr90_SQRaVqYI239Ka1erkI </td> 
         <td>卡券ID。 </td>
        </tr> 
        <tr> 
         <td>add_bonus </td> 
         <td>是 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>需要变更的积分，扣除积分用“-“表示。 </td>
        </tr> 
        <tr> 
         <td>bonus </td> 
         <td>是 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>需要设置的积分全量值，传入的数值会直接显示，如果同时传入add_bonus和bonus,则前者无效。 </td>
        </tr> 
        <tr> 
         <td>record_bonus </td> 
         <td>否 </td> 
         <td>string(42) </td> 
         <td>消费30元，获得3积分 </td> 
         <td>商家自定义积分消耗记录，不超过14个汉字。 </td>
        </tr> 
        <tr> 
         <td>add_balance </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>需要变更的余额，扣除金额用“-”表示。单位为分。 </td>
        </tr> 
        <tr> 
         <td>balance </td> 
         <td>是 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>需要设置的余额全量值，传入的数值会直接显示，如果同时传入add_balance和balance,则前者无效。 </td>
        </tr> 
        <tr> 
         <td>record_balance </td> 
         <td>否 </td> 
         <td>string(42) </td> 
         <td>购买焦糖玛琪朵一杯，扣除金额30元。 </td> 
         <td>商家自定义金额消耗记录，不超过14个汉字。 </td>
        </tr> 
        <tr> 
         <td>custom_field_value1 </td> 
         <td>否 </td> 
         <td>string（12） </td> 
         <td>白金 </td> 
         <td>创建时字段custom_field1定义类型的最新数值，限制为4个汉字，12字节。 </td>
        </tr> 
        <tr> 
         <td>custom_field_value2 </td> 
         <td>否 </td> 
         <td>string（12） </td> 
         <td>8折 </td> 
         <td>创建时字段custom_field2定义类型的最新数值，限制为4个汉字，12字节。 </td>
        </tr> 
        <tr> 
         <td>custom_field_value3 </td> 
         <td>否 </td> 
         <td>string（12） </td> 
         <td>500 </td> 
         <td>创建时字段custom_field3定义类型的最新数值，限制为4个汉字，12字节。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回说明</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok",
   "result_bonus": 100,
   "result_balance": 200,
   "openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息。 </td>
        </tr> 
        <tr> 
         <td> result_bonus </td> 
         <td> 当前用户积分总额。 </td>
        </tr> 
        <tr> 
         <td> result_balance </td> 
         <td> 当前用户预存总金额。 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 用户openid。 </td>
        </tr> 
       </tbody>
      </table> 
      <h1> <span class="mw-headline" id=".E7.AE.A1.E7.90.86.E4.BC.9A.E5.91.98.E5.8D.A1"><b>管理会员卡</b></span></h1> 
      <h3> <span class="mw-headline" id=".E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3"><b>查询Code接口</b></span></h3> 
      <p>查询code接口可以查询当前code是否可以被核销并检查code状态。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/code/get?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/code/get?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
   "card_id"&nbsp;: "card_id_123+",
   "code"&nbsp;: "123456789",
   "check_consume"&nbsp;: true
}
</pre> 
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> 110201201245 </td> 
         <td> 单张卡券的唯一标准。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID代表一类卡券。 </td>
        </tr> 
        <tr> 
         <td> check_consume </td> 
         <td> 否 </td> 
         <td> bool </td> 
         <td> true </td> 
         <td> 是否校验code核销状态，填入true和false时的code异常状态返回数据不同。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> </p>
      <p><b>当check_consume为true时返回数据</b> </p>
      <p>卡券状态正常： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"card":{
"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"begin_time": 1404205036,
"end_time": 1404205036,
"user_card_status": "NORMAL",
"can_consume":"true"
  }
}
</pre> 
      <p>卡券状态异常： </p> 
      <pre>{
 "errcode": 40127,
 "errmsg": "invalid user-card status! Hint: the card was given to user, but may be    deleted or set unavailable&nbsp;! hint: [iHBD40040ent3]"
}
</pre> 
      <p><b>当check_consume为false时返回数据</b> </p>
      <p>卡券状态正常： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"card":{
"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"begin_time": 1404205036,
"end_time": 1404205036
"can_consume":"true"
  }
}
</pre> 
      <p>卡券状态异常： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"card":{
"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"begin_time": 1404205036,
"end_time": 1404205036,
"user_card_status": "GIFTING",
"can_consume":"false"
  }
}
</pre> 
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 用户openid </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 卡券ID </td>
        </tr> 
        <tr> 
         <td> begin_time </td> 
         <td> 起始使用时间 </td>
        </tr> 
        <tr> 
         <td> end_time </td> 
         <td> 结束时间 </td>
        </tr> 
        <tr> 
         <td> user_card_status </td> 
         <td> 当前code对应卡券的状态， NORMAL 正常 CONSUMED 已核销 EXPIRE 已过期 GIFTING 转赠中 <p>GIFT_TIMEOUT 转赠超时 DELETE 已删除，UNAVAILABLE 已失效 code未被添加或被转赠领取的情况则统一报错：invalid serial code </p> </td>
        </tr> 
        <tr> 
         <td> can_consume </td> 
         <td> 是否可以核销，true为可以核销，false为不可核销 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注： 1.固定时长有效期会根据用户实际领取时间转换，如用户2013年10月1日领取，固定时长有效期为90天，即有效时间为2013年10月1日-12月29日有效。 </p>
      <p>2.无论书check_consume填写的是true还是false,当code未被添加或者code被转赠领取是统一报错：invalid serial code </p> 
      <h2> <span class="mw-headline" id=".E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.B7.B2.E9.A2.86.E5.8F.96.E7.9A.84.E5.8D.A1.E5.88.B8"><b>获取用户已领取的卡券</b></span></h2> 
      <p>支持开发者调用该接口获取指定用户卡包中属于该appid下的卡券。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/user/getcardlist?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/user/getcardlist?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  "openid": "12312313",
  "card_id": "xxxxxxxxxx"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 是 </td> 
         <td> string(64) </td> 
         <td> 1231231 </td> 
         <td> 需要查询的用户openid </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01xxxxx </td> 
         <td> 卡券ID。不填写时默认查询当前appid下的卡券。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
"card_list": [
      {"code": "xxx1434079154", "card_id": "xxxxxxxxxx"},
      {"code": "xxx1434079155", "card_id": "xxxxxxxxxx"}
      ]
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td>card_list </td> 
         <td>卡券列表 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.8B.89.E5.8F.96.E4.BC.9A.E5.91.98.E4.BF.A1.E6.81.AF.EF.BC.88.E7.A7.AF.E5.88.86.E6.9F.A5.E8.AF.A2.EF.BC.89.E6.8E.A5.E5.8F.A3"><b>拉取会员信息（积分查询）接口</b></span></h2> 
      <p><b>接口说明</b> </p>
      <p>支持开发者根据CardID和Code查询会员信息 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
   "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8",
   "code": "916679873278"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数名 </th> 
         <th style="width:120px">是否必填 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> cardid </td> 
         <td> 是 </td> 
         <td> 查询会员卡的cardid </td>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> 所查询用户领取到的code值 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "openid": "obLatjjwDolFjRRd3doGIdwNqRXw",
 "nickname": "Fourier",
 "membership_number": "316510891298",
 "bonus": 460,
 "sex": "MALE",
 "user_info": {
   "common_field_list": [
     {
       "name": "USER_FORM_INFO_FLAG_MOBILE",
       "value": "15521328888"
     },
     {
       "name": "USER_FORM_INFO_FLAG_NAME",
       "value": "微信"
     }
   ],
   "custom_field_list": []
 },
 "user_card_status": "NORMAL"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 用户在本公众号内唯一识别码 </td>
        </tr> 
        <tr> 
         <td> nickname </td> 
         <td> 用户昵称 </td>
        </tr> 
        <tr> 
         <td> bonus </td> 
         <td> 积分信息 </td>
        </tr> 
        <tr> 
         <td> balance </td> 
         <td> 余额信息 </td>
        </tr> 
        <tr> 
         <td> sex </td> 
         <td> 用户性别 </td>
        </tr> 
        <tr> 
         <td> user_info </td> 
         <td> 会员信息 </td>
        </tr> 
        <tr> 
         <td> custom_field_list </td> 
         <td> 开发者设置的会员卡会员信息类目，如等级。 </td>
        </tr> 
        <tr> 
         <td> name </td> 
         <td> 会员信息类目名称 </td>
        </tr> 
        <tr> 
         <td> value </td> 
         <td> 会员卡信息类目值，比如等级值等 </td>
        </tr> 
        <tr> 
         <td> user_card_status </td> 
         <td> 当前用户会员卡状态，NORMAL 正常 EXPIRE 已过期 GIFTING 转赠中 GIFT_SUCC 转赠成功 GIFT_TIMEOUT 转赠超时 DELETE 已删除，UNAVAILABLE 已失效 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85"><b>查看卡券详情</b></span></h2> 
      <p>调用该接口可查询卡券字段详情及卡券所处状态。建议开发者调用卡券更新信息接口后调用该接口验证是否更新成功。 </p>
      <p><b>开发者注意事项</b> </p>
      <p>1.对于部分有特殊权限的商家，查询卡券详情得到的返回可能含特殊接口的字段。 </p>
      <p>2.由于卡券字段会持续更新，实际返回字段包含但不限于文档中的字段，建议开发者开发时对于不理解的字段不做处理，以免出错。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/get?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/get?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  "card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> cardid </td> 
         <td> 是 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode": 0,
   "errmsg": "ok",
   "card": {
       "card_type":  "GROUPON",
           "groupon": {
           "base_info": {
               "status": 1,
               "id": "p1Pj9jr90_SQRaVqYI239Ka1erkI",
               "logo_url": "<a href="http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0</a>",
               "appid": "wx588def6b0089dd48",
               "code_type": "CODE_TYPE_TEXT",
               "brand_name": "海底捞",
               "title": "132元双人火锅套餐",
               "sub_title": "",
               "date_info": {
                   "type": 1,
                   "begin_timestamp": 1397577600,
                   "end_timestamp": 1399910400
               },
               "color": "#3373bb",
               "notice": "使用时向服务员出示此券",
               "service_phone": "020-88888888",
               "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食\n餐前不可打包，餐后未吃完，可打包\n本团购券不限人数，建议2人使用，超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料",
               "use_limit": 1,
               "get_limit": 3,
               "can_share": true,
               "location_id_list"&nbsp;: [123, 12321, 345345]
               "custom_url_name": "立即使用",
               "custom_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a>",
               "custom_url_sub_title": "6个汉字tips",
               "promotion_url_name": "更多优惠",
               "promotion_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a>",
               "source": "大众点评"   
               "sku": {
                   "quantity": 0
                   "total_quantity"：1000
               }
           },
           "deal_detail": "以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸菜鱼锅可选）：\n大锅1份 12元\n小锅2份 16元\n以下菜品2选1\n特级肥牛1份 30元\n洞庭鮰鱼卷1份 20元\n其他\n鲜菇猪肉滑1份 18元\n金针菇1份 16元\n黑木耳1份 9元\n娃娃菜1份 8元\n冬瓜1份 6元\n火锅面2个 6元\n欢乐畅饮2位 12元\n自助酱料2位 10元",
       }
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> card_type </td> 
         <td> 卡券类型。 <p>团购券：GROUPON; 折扣券：DISCOUNT; 礼品券：GIFT; 代金券：CASH; 通用券：GENERAL_COUPON; 会员卡：MEMBER_CARD; 景点门票：SCENIC_TICKET； 电影票：MOVIE_TICKET； 飞机票：BOARDING_PASS； 会议门票：MEETING_TICKET； 汽车票：BUS_TICKET; </p> </td>
        </tr> 
        <tr> 
         <td> base_info </td> 
         <td> 基本的卡券数据，见下表，所有卡券通用。 </td>
        </tr> 
        <tr> 
         <td> deal_detail </td> 
         <td> 团购券专用字段，团购详情。 </td>
        </tr> 
        <tr> 
         <td> gift </td> 
         <td> 礼品券专用，表示礼品名字。 </td>
        </tr> 
        <tr> 
         <td> least_cost </td> 
         <td> least_cost字段为代金券专用，表示起用金额（单位为分）。 </td>
        </tr> 
        <tr> 
         <td> reduce_cost </td> 
         <td> 代金券专用，表示减免金额（单位为分） </td>
        </tr> 
        <tr> 
         <td> discount </td> 
         <td> 折扣券专用字段，表示打折额度（百分比），例：填30为七折团购详情。 </td>
        </tr> 
        <tr> 
         <td>supply_balance </td> 
         <td>会员卡专属字段，表示是否支持积分，填写true或false，如填写true，积分相关字段均为必填。 </td>
        </tr> 
        <tr> 
         <td>supply_bonus </td> 
         <td>会员卡专属字段，表示否支持储值，填写true或false，如填写true，储值相关字段均为必填。 </td>
        </tr> 
        <tr> 
         <td>bonus_cleared </td> 
         <td>积分清零规则。 </td>
        </tr> 
        <tr> 
         <td>bonus_rules </td> 
         <td>积分规则。 </td>
        </tr> 
        <tr> 
         <td>balance_rules </td> 
         <td>储值规则。 </td>
        </tr> 
        <tr> 
         <td>prerogative </td> 
         <td>会员卡专属字段，表示特权说明。 </td>
        </tr> 
        <tr> 
         <td>bind_old_card_url </td> 
         <td>绑定旧卡的url。 </td>
        </tr> 
        <tr> 
         <td>activate_url </td> 
         <td>激活会员卡。 </td>
        </tr> 
        <tr> 
         <td>need_push_on_view </td> 
         <td>进入会员卡时是否推送事件，填写true或false。 </td>
        </tr> 
        <tr> 
         <td>bonus_rule </td> 
         <td>积分规则。用于<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E8.AE.BE.E7.BD.AE.E5.BE.AE.E4.BF.A1.E4.B9.B0.E5.8D.95.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">微信买单功能</a>。 </td>
        </tr> 
        <tr> 
         <td>cost_money_unit </td> 
         <td>消费金额。以分为单位。 </td>
        </tr> 
        <tr> 
         <td>increase_bonus </td> 
         <td>对应增加的积分。 </td>
        </tr> 
        <tr> 
         <td>max_increase_bonus </td> 
         <td>积分上限。 </td>
        </tr> 
        <tr> 
         <td>init_increase_bonus </td> 
         <td>初始设置积分。 </td>
        </tr> 
        <tr> 
         <td>discount </td> 
         <td>折扣，该会员卡享受的折扣优惠。 </td>
        </tr> 
        <tr> 
         <td>from </td> 
         <td>飞机票的起点，上限为18个汉字。 </td>
        </tr> 
        <tr> 
         <td>to </td> 
         <td>飞机票的终点，上限为18个汉字。 </td>
        </tr> 
        <tr> 
         <td>flight </td> 
         <td>航班。 </td>
        </tr> 
        <tr> 
         <td>departure_time </td> 
         <td>起飞时间。（Unix时间戳格式） </td>
        </tr> 
        <tr> 
         <td>landing_time </td> 
         <td>降落时间。（Unix时间戳格式） </td>
        </tr> 
        <tr> 
         <td>check_in_url </td> 
         <td>在线值机的链接。 </td>
        </tr> 
        <tr> 
         <td>gate </td> 
         <td>登机口。如发生登机口变更，建议商家实时调用该接口变更。 </td>
        </tr> 
        <tr> 
         <td>boarding_time </td> 
         <td>登机时间，只显示“时分”不显示日期。（Unix时间戳格式） </td>
        </tr> 
        <tr> 
         <td>meeting_detail </td> 
         <td>会议详情。 </td>
        </tr> 
        <tr> 
         <td>map_url </td> 
         <td>会场导览图。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>base_info字段： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>logo_url </td> 
         <td>卡券的商户logo，建议像素为300*300。 </td>
        </tr> 
        <tr> 
         <td>code_type </td> 
         <td>"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示； </td>
        </tr> 
        <tr> 
         <td>brand_name </td> 
         <td>商户名字（填写直接提供服务的商户名，第三方商户名填写在source字段）。 </td>
        </tr> 
        <tr> 
         <td>title </td> 
         <td>卡券名。 </td>
        </tr> 
        <tr> 
         <td>sub_title </td> 
         <td>卡券名的副标题。 </td>
        </tr> 
        <tr> 
         <td>color </td> 
         <td>卡券的背景颜色。 </td>
        </tr> 
        <tr> 
         <td>notice </td> 
         <td>使用提醒，字数上限为16个汉字。 </td>
        </tr> 
        <tr> 
         <td>description </td> 
         <td>使用说明。长文本描述。 </td>
        </tr> 
        <tr> 
         <td>date_info </td> 
         <td>使用日期，有效期的信息。 </td>
        </tr> 
        <tr> 
         <td>type </td> 
         <td>使用时间的类型。DATE_TYPE_FIX_TIME_RANGE 表示固定日期区间，DATE_TYPE_FIX_TERM表示固定时长（自领取后按天算），DATE_TYPE_PERMANENT 表示永久有效（会员卡专用时间类型）。 </td>
        </tr> 
        <tr> 
         <td>begin_timestamp </td> 
         <td>type为DATE_TYPE_FIX_TIME_RANGE时专用，表示起用时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入，下同。（单位为秒） </td>
        </tr> 
        <tr> 
         <td>end_timestamp </td> 
         <td>type为DATE_TYPE_FIX_TIME_RANGE时专用，表示结束时间。（单位为秒） </td>
        </tr> 
        <tr> 
         <td>fixed_term </td> 
         <td>type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天内有效，领取后当天有效填写0。（单位为天） </td>
        </tr> 
        <tr> 
         <td>fixed_begin_term </td> 
         <td>type为DATE_TYPE_FIX_TERM时专用，表示自领取后多少天开始生效。（单位为天） </td>
        </tr> 
        <tr> 
         <td>sku </td> 
         <td>商品信息 </td>
        </tr> 
        <tr> 
         <td>quantity </td> 
         <td>卡券现有库存的数量。 </td>
        </tr> 
        <tr> 
         <td>total_quantity </td> 
         <td>卡券全部库存的数量。 </td>
        </tr> 
        <tr> 
         <td>location_id_list </td> 
         <td>门店位置ID。 </td>
        </tr> 
        <tr> 
         <td>use_custom_code </td> 
         <td>是否自定义Code码。填写true或false，默认为false。 </td>
        </tr> 
        <tr> 
         <td>bind_openid </td> 
         <td>是否指定用户领取，填写true或false。默认为否。 </td>
        </tr> 
        <tr> 
         <td>can_share </td> 
         <td>卡券是否可转赠，填写true或false,true代表可转赠。默认为true。 </td>
        </tr> 
        <tr> 
         <td>service_phone </td> 
         <td>客服电话。 </td>
        </tr> 
        <tr> 
         <td>source </td> 
         <td>第三方来源名，例如同程旅游、大众点评。 </td>
        </tr> 
        <tr> 
         <td>custom_url_name </td> 
         <td>商户自定义入口名称。 </td>
        </tr> 
        <tr> 
         <td>custom_url </td> 
         <td>商户自定义入口跳转外链的地址链接,跳转页面内容需与自定义cell名称保持匹配。 </td>
        </tr> 
        <tr> 
         <td>custom_url_sub_title </td> 
         <td>显示在入口右侧的tips，长度限制在6个汉字内。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_name </td> 
         <td>营销场景的自定义入口。 </td>
        </tr> 
        <tr> 
         <td>promotion_url </td> 
         <td>入口跳转外链的地址链接。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_sub_title </td> 
         <td>显示在营销入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>custom_url_name </td> 
         <td>商户自定义入口名称。 </td>
        </tr> 
        <tr> 
         <td>status </td> 
         <td>“CARD_STATUS_NOT_VERIFY”,待审核；“CARD_STATUS_VERIFY_FAIL”,审核失败；“CARD_STATUS_VERIFY_OK”，通过审核；“CARD_STATUS_DELETE”，卡券被用户删除；“CARD_STATUS_USER_DISPATCH”，在公众平台投放过的卡券 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.89.B9.E9.87.8F.E6.9F.A5.E8.AF.A2.E5.8D.A1.E5.88.97.E8.A1.A8"><b>批量查询卡列表</b></span></h2> 
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/batchget?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/batchget?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  "offset": 0,
  "count": 10, 
  "status_list": ["CARD_STATUS_VERIFY_OK", "CARD_STATUS_DISPATCH"]
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> offset </td> 
         <td> 是 </td> 
         <td> int </td> 
         <td> 0 </td> 
         <td> 查询卡列表的起始偏移量，从0开始，即offset: 5是指从从列表里的第六个开始读取。 </td>
        </tr> 
        <tr> 
         <td> count </td> 
         <td> 是 </td> 
         <td> int </td> 
         <td> 10 </td> 
         <td> 需要查询的卡片的数量（数量最大50）。 </td>
        </tr> 
        <tr> 
         <td> status_list </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> CARD_STATUS_VERIFY_OK </td> 
         <td> 支持开发者拉出指定状态的卡券列表，例：仅拉出通过审核的卡券。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre>{
  "errcode":0,
  "errmsg":"ok",
  "card_id_list":["ph_gmt7cUVrlRk8swPwx7aDyF-pg"],
  "total_num":1
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息。 </td>
        </tr> 
        <tr> 
         <td> card_id_list </td> 
         <td> 卡券ID列表。 </td>
        </tr> 
        <tr> 
         <td> total_num </td> 
         <td> 该商户名下卡券ID总数。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> </p> 
      <h2> <span class="mw-headline" id=".E6.9B.B4.E6.94.B9.E5.8D.A1.E5.88.B8.E4.BF.A1.E6.81.AF.E6.8E.A5.E5.8F.A3"><b>更改卡券信息接口</b> </span></h2> 
      <p><b>接口说明</b> </p>
      <p>支持更新所有卡券类型的部分通用字段及特殊卡券（会员卡、飞机票、电影票、会议门票）中特定字段的信息。 </p>
      <p><b>开发者注意事项注</b> </p>
      <p>1. 更改卡券的部分字段后会重新提交审核，详情见字段说明，更新成功后可通过调用查看卡券详情接口核查更新结果； </p>
      <p>2. 仅填入需要更新的字段，许多开发者在调用该接口时会填入brandname等不支持修改的字段，导致更新不成功。 </p>
      <p><font color="#FF0000"> 3. 调用该接口后更改卡券信息后，请务必调用<a href="../14/8dd77aeaee85f922db5f8aa6386d385e.html#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85" class="external text" rel="nofollow">查看卡券详情接口</a>验证是否已成功更改。 </font> </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/update?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/update?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
       "card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
       "member_card": {        //填写该cardid相应的卡券类型（小写）。
               "base_info": {
                   "logo_url": "http:\/\/www.supadmin.cn\/uploads\/allimg\/120216\/1_120216214725_1.jpg",
                   "color": "Color010",
                   "notice": "使用时向服务员出示此券",
                   "service_phone": "020-88888888",
                   "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食\n餐前不可打包，餐后未吃完，可打包\n本团购券不限人数，建议2人使用，超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料"
                   "location_id_list"&nbsp;: [123, 12321, 345345]
               },
                  "bonus_cleared": "aaaaaaaaaaaaaa",
                  "bonus_rules": "aaaaaaaaaaaaaa",
                  "prerogative": "",
                  "auto_activate"&nbsp;: true,//也可以填写wx_activate
                  "activate_url"：""
       }
}
</pre> 
      <p><br> 支持修改字段： base_info字段： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>是否提审 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>logo_url </td> 
         <td>是 </td> 
         <td>string(128) </td> 
         <td><a href="http://mmbiz.qpic.cn/" class="external free" rel="nofollow">http://mmbiz.qpic.cn/</a> </td> 
         <td>卡券的商户logo，建议像素为300*300。 </td>
        </tr> 
        <tr> 
         <td>notice </td> 
         <td>是 </td> 
         <td>string（48） </td> 
         <td>请出示二维码核销卡券。 </td> 
         <td>使用提醒，字数上限为16个汉字。 </td>
        </tr> 
        <tr> 
         <td>description </td> 
         <td>是 </td> 
         <td>string（3072） </td> 
         <td>不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食。 </td> 
         <td>使用说明。 </td>
        </tr> 
        <tr> 
         <td>service_phone </td> 
         <td>否 </td> 
         <td>string（24） </td> 
         <td>40012234 </td> 
         <td>客服电话。 </td>
        </tr> 
        <tr> 
         <td>color </td> 
         <td>是 </td> 
         <td>string（3072） </td> 
         <td>Color010 </td> 
         <td>卡券颜色。 </td>
        </tr> 
        <tr> 
         <td>location_id_list </td> 
         <td>否 </td> 
         <td>string（3072） </td> 
         <td>1234,2314 </td> 
         <td>支持更新适用门店列表。 </td>
        </tr> 
        <tr> 
         <td>custom_url_name </td> 
         <td>否 </td> 
         <td>string（16） </td> 
         <td>立即使用 </td> 
         <td>自定义跳转入口的名字。 </td>
        </tr> 
        <tr> 
         <td>custom_url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>"xxxx.com"。 </td> 
         <td>自定义跳转的URL。 </td>
        </tr> 
        <tr> 
         <td>custom_url_sub_title </td> 
         <td>否 </td> 
         <td>string（18） </td> 
         <td>更多惊喜 </td> 
         <td>显示在入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_name </td> 
         <td>否 </td> 
         <td>string（16） </td> 
         <td>产品介绍。 </td> 
         <td>营销场景的自定义入口名称。 </td>
        </tr> 
        <tr> 
         <td>promotion_url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>XXXX.com； </td> 
         <td>入口跳转外链的地址链接。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_sub_title </td> 
         <td>否 </td> 
         <td>string（18） </td> 
         <td>卖场大优惠。 </td> 
         <td>显示在营销入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>code_type </td> 
         <td>否 </td> 
         <td>string（16） </td> 
         <td>CODE_TYPE_TEXT。 </td> 
         <td>Code码展示类型，"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示； </td>
        </tr> 
        <tr> 
         <td>get_limit </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>1 </td> 
         <td>每人可领券的数量限制。 </td>
        </tr> 
        <tr> 
         <td>can_share </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>false </td> 
         <td>卡券原生领取页面是否可分享。 </td>
        </tr> 
        <tr> 
         <td>can_give_friend </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>false </td> 
         <td>卡券是否可转赠。 </td>
        </tr> 
        <tr> 
         <td>date_info </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例 </td> 
         <td>使用日期，有效期的信息，有效期时间修改仅支持有效区间的扩大。 </td>
        </tr> 
        <tr> 
         <td>type </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>1 </td> 
         <td>有效期类型，仅支持更改type为1的时间戳，不支持填入2。 </td>
        </tr> 
        <tr> 
         <td>begin_timestamp </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>14300000 </td> 
         <td>固定日期区间专用，表示起用时间。（单位为秒） </td>
        </tr> 
        <tr> 
         <td>end_timestamp </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>15300000 </td> 
         <td>固定日期区间专用，表示结束时间。结束时间仅支持往后延长。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>会员卡专属字段修改： </p>
      <p>特别注意，以下支持更新的字段不在基本信息base_info的结构中。 </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>是否提审 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> bonus_cleared </td> 
         <td> 是 </td> 
         <td> string(3072) </td> 
         <td> 每年12月30号积分清0。 </td> 
         <td> 积分清零规则。 </td>
        </tr> 
        <tr> 
         <td> bonus_rules </td> 
         <td> 是 </td> 
         <td> string(3072) </td> 
         <td> 每消费1元增加1积分。 </td> 
         <td> 积分规则。 </td>
        </tr> 
        <tr> 
         <td> balance_rules </td> 
         <td> 是 </td> 
         <td> string(3072) </td> 
         <td> 支持在线充入余额。 </td> 
         <td> 储值说明。 </td>
        </tr> 
        <tr> 
         <td> prerogative </td> 
         <td> 是 </td> 
         <td> string(3072) </td> 
         <td> XX会员可享有全场商品8折优惠。 </td> 
         <td> 特权说明。 </td>
        </tr> 
        <tr> 
         <td> wx_activate </td> 
         <td> 否 </td> 
         <td> bool </td> 
         <td> true </td> 
         <td> 是否开通一键开卡，设置为true时用户领取会员卡点击激活进入原生激活页面，若填入之前设置了activate_url,则更新时须将activate_url传空值，并设置开卡项详情见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E4.B8.80.E9.94.AE.E5.BC.80.E5.8D.A1" class="external text" rel="nofollow">一键开卡</a>。 </td>
        </tr> 
        <tr> 
         <td> auto_activate </td> 
         <td> 否 </td> 
         <td> bool </td> 
         <td> true </td> 
         <td> 是否开通自动激活，设置为true时用户领取会员卡自动设置为激活，详情见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E8.87.AA.E5.8A.A8.E6.BF.80.E6.B4.BB" class="external text" rel="nofollow">自动激活</a>。 </td>
        </tr> 
        <tr> 
         <td>custom_field1 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E5.88.9B.E5.BB.BA.E4.BC.9A.E5.91.98.E5.8D.A1" class="external text" rel="nofollow">创建会员卡示例</a>。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>custom_field2 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E5.88.9B.E5.BB.BA.E4.BC.9A.E5.91.98.E5.8D.A1" class="external text" rel="nofollow">创建会员卡示例</a>。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>custom_field3 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E6.AD.A5.E9.AA.A4.E4.B8.80.EF.BC.9A.E5.88.9B.E5.BB.BA.E4.BC.9A.E5.91.98.E5.8D.A1" class="external text" rel="nofollow">创建会员卡示例</a>。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>name_type </td> 
         <td>否 </td> 
         <td>string(24) </td> 
         <td>FIELD_NAME_TYPE_LEVEL </td> 
         <td>会员信息类目名称。FIELD_NAME_TYPE_LEVEL等级；FIELD_NAME_TYPE_COUPON优惠券；FIELD_NAME_TYPE_STAMP印花；FIELD_NAME_TYPE_DISCOUNT折扣；FIELD_NAME_TYPE_ACHIEVEMEN成就；FIELD_NAME_TYPE_MILEAGE里程。 </td>
        </tr> 
        <tr> 
         <td>url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>xxx.com </td> 
         <td>点击类目跳转外链url </td>
        </tr> 
        <tr> 
         <td>custom_cell1 </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例。 </td> 
         <td>自定义会员信息类目，会员卡激活后显示。 </td>
        </tr> 
        <tr> 
         <td>bonus_rule </td> 
         <td>否 </td> 
         <td>json结构 </td> 
         <td>见上述示例 </td> 
         <td>积分规则。用于<a href="../15/de148cc4b5190c80002eaf4f6f26c717.html#.E8.AE.BE.E7.BD.AE.E5.BE.AE.E4.BF.A1.E4.B9.B0.E5.8D.95.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">微信买单功能</a>。 </td>
        </tr> 
        <tr> 
         <td>cost_money_unit </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>消费金额。以分为单位。 </td>
        </tr> 
        <tr> 
         <td>increase_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>对应增加的积分。 </td>
        </tr> 
        <tr> 
         <td>max_increase_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10000 </td> 
         <td>单次获取的积分上限。 </td>
        </tr> 
        <tr> 
         <td>init_increase_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>初始设置积分。 </td>
        </tr> 
        <tr> 
         <td>cost_bonus_unit </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>每使用5积分。 </td>
        </tr> 
        <tr> 
         <td>reduce_money </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>抵扣xx元，（这里以分为单位） </td>
        </tr> 
        <tr> 
         <td>least_money_to_use_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>100 </td> 
         <td>抵扣条件，满xx元（这里以分为单位）可用。 </td>
        </tr> 
        <tr> 
         <td>max_reduce_bonus </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>抵扣条件，单笔最多使用xx积分。 </td>
        </tr> 
        <tr> 
         <td>discount </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>10 </td> 
         <td>折扣，该会员卡享受的折扣优惠。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据说明</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok",
  "send_check"：true
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息。 </td>
        </tr> 
        <tr> 
         <td> send_check </td> 
         <td> 此次更新是否需要提审，true为需要，false为不需要。 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E4.BF.AE.E6.94.B9.E5.BA.93.E5.AD.98.E6.8E.A5.E5.8F.A3"><b>修改库存接口</b></span></h2> 
      <p>调用修改库存接口增减某张卡券的库存。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/modifystock?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/modifystock?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"increase_stock_value": 1231231,
"reduce_stock_value": 1231231
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 是 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> increase_stock_value </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 1231231 </td> 
         <td> 增加多少库存，支持不填或填0。 </td>
        </tr> 
        <tr> 
         <td> reduce_stock_value </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 1231231 </td> 
         <td> 减少多少库存，可以不填或填0。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr>
       </tbody>
      </table> 
      <p><br> </p> 
      <h2> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E8.B7.9F.E9.9A.8F.E6.8E.A8.E8.8D.90"><b>设置跟随推荐</b></span></h2> 
      <p><b>功能介绍</b> </p>
      <p>支持开发者在积分变动消息底部，配置卡券或设置跳转外链URL，具体形式如下图，可以是URL也可以是一张卡券。 </p>
      <p><a href="#" class="image"><img alt="跟随推荐.png" src="../static/assets/70e83fc6429f9533f5b1ffbec0fd5072.png" width="760" height="377"></a> </p>
      <p><b>开发者注意事项</b> </p>
      <p>一、支持两种类型的跟随推荐配置 </p>
      <p>1. Wording+URL，支持商户配置16个汉字长度的文案，及点击跳转的链接。 </p>
      <p>2. 推荐卡券，支持商户配置一个本公众号下的卡券。 </p>
      <p>二、推荐位有效期控制 </p>
      <p>1. Wording+URL类型，支持商户根据活动期限自定义展示时间。 </p>
      <p>2. 推荐卡券类型，由微信后台判断卡券的有效性，当卡券已过期、已被领完、已被置为失效会自动下架展示。 </p>
      <p>三、配置规则 支持商户针对指定cardid的不同消息类型配置不同的推荐位内容。（前期仅以会员卡积分变动、卡券核销消息试点） </p>
      <p><br> </p> 
      <h3> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E8.B7.9F.E9.9A.8F.E6.8E.A8.E8.8D.90.E6.8E.A5.E5.8F.A3"><b>设置跟随推荐接口</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>调用更新卡券信息接口将增推荐位字段 update到已成功通过审核的卡券。 同时支持在创建卡券时填入相应字段。 </p>
      <p><br> <b>接口详情</b> </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/update?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/update?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>使用消息配置卡券</b> </p> 
      <pre>{
  "card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
   "member_card":{
          "modify_msg_operation":{
             "card_cell":{
                "end_time":1452724561,
                "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
         }  
       }
     }
   }
 
</pre> 
      <p><br> <b>使用消息配置URL</b> </p> 
      <pre>{
  "card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
   "member_card":{
          "modify_msg_operation":{
             "url_cell":{
                "end_time":1452724561,
                "text":"更多优惠",
                "url":"www.qq.com"
         }  
       }
     }
   }
 
</pre> 
      <p><b>字段说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段名 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> modify_msg_operation </td> 
         <td> 积分余额变动消息类型 </td>
        </tr> 
        <tr> 
         <td> card_cell </td> 
         <td> 卡券类型的推荐位。Json结构参考示例。 </td>
        </tr> 
        <tr> 
         <td> url_cell </td> 
         <td> 链接类型的推荐位。Json结构参考示例。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 需要在运营位投放的卡券id </td>
        </tr> 
        <tr> 
         <td> end_time </td> 
         <td> 推荐位展示的截止时间。 </td>
        </tr> 
        <tr> 
         <td> text </td> 
         <td> 文本内容。 </td>
        </tr> 
        <tr> 
         <td> url </td> 
         <td> 跳转链接。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> </p>
      <p><br> <b>返回数据</b> </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok"
 }
</pre> 
      <p><br> </p>
      <p><b>字段说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段名 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> 错误码 </td> 
         <td> 错误码，0为正常；43008为商户没有开通微信支付权限； </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E5.BE.AE.E4.BF.A1.E4.B9.B0.E5.8D.95.E6.8E.A5.E5.8F.A3"><b>设置微信买单接口</b></span></h2> 
      <p>微信卡券买单功能是微信卡券的一项新的能力，可以方便消费者买单时，直接录入消费金额，自动使用领到的优惠（券或卡）抵扣，并拉起微信支付快速完成付款。支持开发者将会员卡设置为支持买单功能的会员卡。 </p>
      <p>微信买单（以下统称微信买单）的好处： </p>
      <p>1、无需商户具备微信支付开发能力，即可完成订单生成，与微信支付打通。 </p>
      <p>2、可以通过手机公众号、电脑商户后台，轻松操作收款并查看核销记录，交易对账，并支持离线下载。 </p>
      <p>3、支持会员营销，二次营销，如会员卡交易送积分，抵扣积分，买单后赠券等。 </p>
      <p><br> <b>开通指引</b> </p>
      <p>步骤一：申请开通内测白名单权限后，开发者可以登录微信公众平台mp.weixin.qq.com，进入【卡券功能】-【卡券概况】，点击查看资料和权限 </p>
      <p>步骤二：在高级权限区，有标注微信买单的权限状态，商户先需要开通微信支付，并为收款门店配置收款员，才能激活申请权限。未获得权限时，点击“申请“，开通买单权限 </p>
      <p>步骤三：为收款门店配置收款员“或直接点击”卡券核销“，可前往添加门店核销员，便于后续接收结算通知。 </p>
      <p><br> </p> 
      <h3> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E4.B9.B0.E5.8D.95.E6.8E.A5.E5.8F.A3"><b>设置买单接口</b></span></h3> 
      <p><b>买单接口说明</b> 创建卡券之后，开发者可以通过设置微信买单接口设置该card_id支持微信买单功能。值得开发者注意的是，设置买单的card_id必须已经配置了门店，否则会报错。 <b>接口详情</b> </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/paycell/set?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/paycell/set?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  “card_id”:“ph_gmt7cUVrlRk8swPwx7aDyF-pg“,
  “is_open”: true
}
</pre> 
      <p><b>字段说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段名 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> cardid </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> is_open </td> 
         <td> 是否开启买单功能，填true/false </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p> 
      <pre> {
   "errcode":0,
   "errmsg":"ok"
 }
</pre> 
      <p><b>字段说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段名 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> 错误码 </td> 
         <td> 错误码，0为正常；43008为商户没有开通微信支付权限或者没有在商户后台申请微信买单功能； </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> </p> 
      <h3> <span class="mw-headline" id=".E4.B9.B0.E5.8D.95.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><b>买单事件推送</b></span></h3> 
      <p>微信买单完成时，微信会把这个事件推送到开发者填写的URL。 推送XML数据包示例： </p> 
      <pre>&lt;xml&gt;
&lt;ToUserName&gt;&lt;![CDATA[gh_e2243xxxxxxx]]&gt;&lt;/ToUserName&gt;
&lt;FromUserName&gt;&lt;![CDATA[oo2VNuOUuZGMxxxxxxxx]]&gt;&lt;/FromUserName&gt;
&lt;CreateTime&gt;1442390947&lt;/CreateTime&gt;
&lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt;
&lt;Event&gt;&lt;![CDATA[user_pay_from_pay_cell]]&gt;&lt;/Event&gt;
&lt;CardId&gt;&lt;![CDATA[po2VNuCuRo-8sxxxxxxxxxxx]]&gt;&lt;/CardId&gt;
&lt;UserCardCode&gt;&lt;![CDATA[38050000000]]&gt;&lt;/UserCardCode&gt;
&lt;TransId&gt;&lt;![CDATA[10022403432015000000000]]&gt;&lt;/TransId&gt;
&lt;LocationId&gt;291710000&lt;/LocationId&gt;
&lt;Fee&gt;&lt;![CDATA[10000]]&gt;&lt;/Fee&gt;
&lt;OriginalFee&gt;&lt;![CDATA[10000]]&gt; &lt;/OriginalFee&gt;
&lt;/xml&gt;
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号。 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 发送方帐号（一个OpenID）。 </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型）。 </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event。 </td>
        </tr> 
        <tr> 
         <td> Event </td> 
         <td> 事件类型，User_pay_from_pay_cell(微信买单事件) </td>
        </tr> 
        <tr> 
         <td> CardId </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> UserCardCode </td> 
         <td> 卡券Code码。 </td>
        </tr> 
        <tr> 
         <td> TransId </td> 
         <td> 微信支付交易订单号（只有使用买单功能核销的卡券才会出现） </td>
        </tr> 
        <tr> 
         <td> LocationName </td> 
         <td> 门店名称，当前卡券核销的门店名称（只有通过卡券商户助手和买单核销时才会出现） </td>
        </tr> 
        <tr> 
         <td> Fee </td> 
         <td> 实付金额，单位为分 </td>
        </tr> 
        <tr> 
         <td> OriginalFee </td> 
         <td> 应付金额，单位为分 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E5.88.A0.E9.99.A4.E5.8D.A1.E5.88.B8"><b>删除卡券</b></span></h2> 
      <p>删除卡券接口允许商户删除任意一类卡券。删除卡券后，该卡券对应已生成的领取用二维码、添加到卡包JS-SDK均会失效。 注意：如用户在商家删除卡券前已领取一张或多张该卡券依旧有效。即删除卡券不能删除已被用户领取，保存在微信客户端中的卡券。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/delete?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/delete?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
   "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 是 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> </p> 
      <h2> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E5.8D.A1.E5.88.B8.E5.A4.B1.E6.95.88.E6.8E.A5.E5.8F.A3"><b>设置卡券失效接口</b></span></h2> 
      <p>为满足改票、退款等异常情况，可调用卡券失效接口将用户的卡券设置为失效状态。 注：设置卡券失效的操作不可逆，即无法将设置为失效的卡券调回有效状态，商家须慎重调用该接口。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/code/unavailable?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/code/unavailable?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>非自定义卡券的请求
{
  "code": "12312313"
}
或自定义code卡券的请求。
{
  "code": "12312313",
  "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 是 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> 1231231 </td> 
         <td> 设置失效的Code码。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
       </tbody>
      </table> 
      <h1> <span class="mw-headline" id=".E7.BB.9F.E8.AE.A1.E4.BC.9A.E5.91.98.E5.8D.A1.E6.95.B0.E6.8D.AE"> 统计会员卡数据 </span></h1> 
      <h2> <span class="mw-headline" id=".E6.8B.89.E5.8F.96.E4.BC.9A.E5.91.98.E5.8D.A1.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><b>拉取会员卡数据接口</b></span></h2> 
      <p><b>接口简介及开发者注意事项</b> </p>
      <p>为支持开发者调用API查看卡券相关数据，微信卡券团队封装数据接口并面向具备卡券功能权限的开发者开放使用。开发者调用该接口可获取本商户下的所有卡券相关的总数据以及指定卡券的相关数据。开发过程请务必注意以下事项： </p>
      <p>1.查询时间区间需&lt;=62天，否则报错{errcode: 61501，errmsg: "date range error"}； </p>
      <p>2.传入时间格式需严格参照示例填写”2015-06-15”，否则报错{errcode":61500,"errmsg":"date format error"}； </p>
      <p>3.需在获取卡券相关数据前区分卡券创建渠道：公众平台创建、调用卡券接口创建。 </p>
      <p><b>接口说明</b> </p>
      <p>支持开发者调用该接口拉取公众平台创建的会员卡相关数据。 </p>
      <p><br> <b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/datacube/getcardmembercardinfo?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/datacube/getcardmembercardinfo?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>｛
 "begin_date":"2015-06-15",
 "end_date":"2015-06-30",
 "cond_source": 0
｝
</pre> 
      <p>参数说明： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">字段 </th> 
         <th>说明 </th> 
         <th>是否必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th>
        </tr> 
        <tr> 
         <td>begin_date </td> 
         <td>查询数据的起始时间。 </td> 
         <td>是 </td> 
         <td>string(16) </td> 
         <td>2015-06-15 </td>
        </tr> 
        <tr> 
         <td>end_date </td> 
         <td>查询数据的截至时间。 </td> 
         <td>是 </td> 
         <td>string(16) </td> 
         <td>2015-06-30 </td>
        </tr> 
        <tr> 
         <td>cond_source </td> 
         <td>卡券来源，0为公众平台创建的卡券数据、1是API创建的卡券数据 </td> 
         <td>是 </td> 
         <td>unsigned int </td> 
         <td>0 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据说明</b> </p> 
      <pre>{
   "list": [
       {
           "ref_date": "2015-06-23",
           "view_cnt": 0,
              "view_user": 0,
              "receive_cnt": 0,
              "receive_user": 0,
              "active_user": 0,
              "verify_cnt": 0,
              "verify_user": 0,
              "total_user": 86,
              "total_receive_user": 95
   ]
}
</pre> 
      <p>字段说明： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td>ref_date </td> 
         <td>日期信息 </td>
        </tr> 
        <tr> 
         <td>view_cnt </td> 
         <td>浏览次数 </td>
        </tr> 
        <tr> 
         <td>view_user </td> 
         <td>浏览人数 </td>
        </tr> 
        <tr> 
         <td>receive_cnt </td> 
         <td>领取次数 </td>
        </tr> 
        <tr> 
         <td>receive_user </td> 
         <td>领取人数 </td>
        </tr> 
        <tr> 
         <td>verify_cnt </td> 
         <td>使用次数 </td>
        </tr> 
        <tr> 
         <td>verify_user </td> 
         <td>使用人数 </td>
        </tr> 
        <tr> 
         <td>active_user </td> 
         <td>激活人数 </td>
        </tr> 
        <tr> 
         <td>total_user </td> 
         <td>有效会员总人数 </td>
        </tr> 
        <tr> 
         <td>total_receive_user </td> 
         <td>历史领取会员卡总人数 </td>
        </tr> 
       </tbody>
      </table> 
      <!-- 
NewPP limit report
Preprocessor node count: 150/1000000
Post-expand include size: 0/2097152 bytes
Template argument size: 0/2097152 bytes
Expensive parser function count: 0/100
--> 
      <div class="printfooter">
        取自“
       <a href="../15/de148cc4b5190c80002eaf4f6f26c717.html">../15/de148cc4b5190c80002eaf4f6f26c717.html</a>”
      </div> 
      <!-- /bodytext --> 
      <!-- catlinks --> 
      <div id="catlinks" class="catlinks catlinks-allhidden"></div> 
      <!-- /catlinks --> 
      <div class="visualClear"></div> 
     </div> 
     <!-- /bodyContent --> 
    </div> 
    <!-- /content --> 
   </div> 
  </div> 
  <!-- footer --> 
  <div class="foot" id="footer"> 
   <ul class="links ft" id="footer-places"> 
    <li class="links_item no_extra" id="footer-about"><a target="_blank" href="http://www.tencent.com/zh-cn/index.shtml">关于腾讯</a></li> 
    <li class="links_item" id="footer-policy"> <a target="_blank" href="#">服务协议</a></li> 
    <li class="links_item" id="footer-contactus"><a target="_blank" href="http://kf.qq.com/special_auto/weixin.html">客服中心</a></li> 
    <li class="links_item" id="footer-contactus"><a href="http://crm2.qq.com/page/portalpage/wpa.php?uin=40012345&amp;f=1&amp;ty=1&amp;ap=000011:400792:|f:Ggzpt1" target="_blank">在线客服</a></li> 
   </ul> 
   <ul id="footer-icons" class="noprint"> 
    <li id="footer-poweredbyico"> <a href="http://www.mediawiki.org/"><img src="../static/assets/1360f2593ddc8c336d455df43678bb00.png" alt="Powered by MediaWiki" width="88" height="31"></a> </li> 
   </ul> 
   <p class="copyright">Copyright&nbsp;© 2012-2016 Tencent. All Rights Reserved.</p> 
  </div> 
  <!-- /footer --> 
  <script src="../static/8de4f51dbc81a02504e69db45b414107.css"></script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "会员卡专区", "wgTitle": "会员卡专区", "wgAction": "view", "wgArticleId": 188, "wgIsArticle": true, "wgUserName": null, "wgUserGroups": ["*"], "wgCurRevisionId": 4191, "wgCategories": [], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []});
}
</script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.loader.load(["mediawiki.util", "mediawiki.legacy.wikibits", "mediawiki.legacy.ajax"]);
	mediaWiki.loader.go();
}
</script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.user.options.set({"ccmeonemails":0,"cols":80,"contextchars":50,"contextlines":5,"date":"default","diffonly":0,"disablemail":0,"disablesuggest":0,"editfont":"default","editondblclick":0,"editsection":1,"editsectiononrightclick":0,"enotifminoredits":0,"enotifrevealaddr":0,"enotifusertalkpages":1,"enotifwatchlistpages":0,"extendwatchlist":0,"externaldiff":0,"externaleditor":0,"fancysig":0,"forceeditsummary":0,"gender":"unknown","hideminor":0,"hidepatrolled":0,"highlightbroken":1,"imagesize":2,"justify":0,"math":1,"minordefault":0,"newpageshidepatrolled":0,"nocache":0,"noconvertlink":0,"norollbackdiff":0,"numberheadings":0,"previewonfirst":0,"previewontop":1,"quickbar":1,"rcdays":7,"rclimit":50,"rememberpassword":0,"rows":25,"searchlimit":20,"showhiddencats":0,"showjumplinks":1,"shownumberswatching":1,"showtoc":1,"showtoolbar":1,"skin":"vector","stubthreshold":0,"thumbsize":2,"underline":2,"uselivepreview":0,"usenewrc":0,"watchcreations":0,"watchdefault":0,"watchdeletion":0,
	"watchlistdays":3,"watchlisthideanons":0,"watchlisthidebots":0,"watchlisthideliu":0,"watchlisthideminor":0,"watchlisthideown":0,"watchlisthidepatrolled":0,"watchmoves":0,"wllimit":250,"variant":"zh-cn","language":"zh-cn","searchNs0":true,"searchNs1":false,"searchNs2":false,"searchNs3":false,"searchNs4":false,"searchNs5":false,"searchNs6":false,"searchNs7":false,"searchNs8":false,"searchNs9":false,"searchNs10":false,"searchNs11":false,"searchNs12":false,"searchNs13":false,"searchNs14":false,"searchNs15":false});;mediaWiki.loader.state({"user.options":"ready"});
}
</script> 
  <!-- fixalpha --> 
  <script type="text/javascript"> if ( window.isMSIE55 ) fixalpha(); </script> 
  <!-- /fixalpha --> 
  <!-- Served in 0.504 secs. --> 
  <script type="text/javascript">
		// @cunjinli
		setTimeout(function() {
			$("#mw-panel .portal .body li a").each(function() {
				var href = $(this).attr("href"),
				    idx = href.lastIndexOf("/");
				if (!/\.html$/.test(href)) return;

				if (idx>=0) href = href.substr(idx+1);
				var r = new RegExp(href+"$");
				if (r.test(location.href)) {
				    $(this).closest(".portal").find("h5").click();
				    return false;
				}
			});
		}, 100);
		</script>   
  <!-- Welcome to ask gy-team -->
  <!-- so -->
 </body>
</html>